详解 Node.js 原 生 模 块 技术 ， 剖析 Node-js 框 架 实战 案例 
总 提供 大 量 的 实际 开发 案例 ， 便 于 读者 通过 案例 实践 巩固 Nodejs 知 识 
总 介绍 网 络 开 发 、 数 据 库 开发 的 同时 ， 穿 插 Express、Koa、Meteor 等 框架 的 前 沿 知识 
名 三 个 完整 的 项 目 案例 开发 过 程 : 个 人 博客 系统 、 任 务 清单 、NPM 包 
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尽 的 源 代码 以 及 代码 注释 。 
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其 适合 希望 通过 编码 实例 学 习 Nodejs 开发 的 人 员 阅 读 。 
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前 言 


2009 年 Nodejs 的 发 布 迅速 掀起 了 一 阵 开 发 热潮 。 一 方面 ，Nodejs 使 用 JavaScript 的 语 
法 使 得 服务 器 和 客户 端 使 用 同一 种 语言 进行 开发 成 为 可 能 ， 另 一 方面 ，Node.js 通过 事件 循环 
和 非 阻 塞 IO 模型 实现 的 异步 处 理 使 得 Node.js 处 理 大 量 IO 操作 具有 独特 的 优势 。Node.js 
技术 目前 非常 年 轻 并 且 正 处 于 高 速 发 展 时 期 ， 无 数 的 开发 者 正 准备 或 者 已 经 进入 这 个 领域 ， 
只 有 扎实 的 语言 基础 和 丰富 的 实战 开发 经 验 才能 在 这 个 快速 发 展 的 领域 立足 。 

目前 图 书市 场 上 关于 Nodejs 零 基础 入 门 的 图 书 并 不 多 , 从 语言 基础 开始 并 结合 案例 实践 
的 书籍 就 更 加 少 了 。 本 书 便 是 以 实战 为 主旨 , 通过 Nodejs 开发 中 最 常用 的 原生 模块 和 典型 的 
项 目 案例 ， 让 读者 全 面 、 深 入 、 透 彻 地 理解 Nodejs 开发 的 各 种 热门 技术 、 各 种 主流 框架 及 其 
整合 使 用 ， 提 高 实际 开发 水 平和 项 目 实战 能 力 。 


本 书 特 色 


1. 内 容 全 面 、 系 统 ， 结 构 合 理 

为 了 便于 读者 了 解 Node.js 的 开发 ， 本 书 详细 、 系 统 地 介绍 入 门 阶段 的 原生 模块 技术 ， 同 
时 涵盖 Nodejs 框架 的 实战 案例 。 

2. 叙述 完整 ， 图 文 并 茂 

为 了 更 好 地 帮助 读者 进行 编程 学 习 ， 书 中 附 有 大 量 的 案例 运行 效果 图 ， 方 便 读 者 查看 效果 。 

3. 结合 实际 ， 案 例 丰 富 

本 书 提供 了 大 量 的 实际 开发 案例 ， 便 于 读者 在 了 解 Nodejs 知识 的 同时 进行 案例 实践 ， 同 
时 书 中 所 有 的 案例 都 给 出 了 完整 的 代码 和 详细 的 注释 。 

4. 涵盖 基础 和 前 沿 知识 

本 书 既 介绍 简单 的 网 络 开发 、 数 据 库 开 发 等 入 门 知识 , 也 同时 穿插 Express、Koa、Meteor 
等 框架 的 前 沿 知识 ， 让 读者 在 了 解 基础 的 同时 紧 跟 前 沿 技术 的 步伐 。 

5. 提供 大 量 的 源 代码 

本 书 涉及 的 所 有 源 代码 都 将 开放 给 读者 ， 以 便于 学 习 ， 下 载 地 址 (注意 数字 和 字母 大 小 
写 ) 如 下 : 

https://pan.baidu.com/s/1qYC3cVa (密码 : bba3) 


如 果 下 载 有 问题 或 者 对 本 书 有 什么 疑问 和 建议 , 请 电子 邮件 联系 booksaga@163.com， 邮 
件 主题 为 “Nodejs 开发 实战 ”。 


本 书 内 容 


第 一 篇 ”Node.js 概述 和 开发 环境 的 搭建 (第 1~2 章 ) 

本 篇 介绍 开发 Node.js 的 主要 特点 、 发 展 历史 和 开发 环境 的 搭建 ， 主 要 包括 Node.js 的 特 
性 、 应 用 场景 、 开 发 环境 的 搭建 以 及 开发 工具 的 选择 。 

第 二 篇 Node.js 编程 基础 (第 3 一 7 章 ) 

本 篇 介绍 Node.js 常用 原生 模块 的 开发 基础 ， 主 要 包括 Node.js 的 包 管 理 、 模 块 机 制 以 及 
Nodejs 开发 中 最 常用 的 文件 模块 、 网 络 开发 模块 、 数 据 库 开 发 模块 等 知识 。 

第 三 篇 Nodejs 实践 (第 8 一 11 章 ) 

本 篇 主要 介绍 Node.js 在 实际 开发 中 的 运用 ， 主 要 包括 Node.js 的 Express、Meteor 框架 、 
Nodejs 的 单元 测试 、Node.js 部 署 中 的 实际 运用 。 

第 四 篇 NodeJjs 项 目 案例 〈 第 12 一 14 章 ) 


本 篇 主要 介绍 3 个 项 目 案例 的 开发 过 程 ， 主 要 包括 个 人 博客 系统 、 任 务 清单 、NPM 包 ， 
涉及 Express、Meteor、NPM 包 的 开发 和 发 布 ， 以 及 需求 分 析 、 数 据 库 设计 、 业 务 层 设计 和 表 
示 层 设计 的 详细 过 程 。 


本 书 读者 


需要 全 面 学 习 Node.js 开发 技术 的 人 员 ; 

广大 Web 开发 程序 员 ; 

Node.js 程序 员 ; 

想 要 进入 Nodejs 领域 的 前 端 开 发 人 员 ; 

希望 提高 项 目 开发 水 平 的 人 员 ; 

专业 培训 机 构 的 学 员 ; 

需要 一 本 案头 必 备 查询 手册 的 Web 前 端 开发 人 员 。 


本 书 由 忽 如 寄主 创 ， 其 他 创作 人 员 还 有 陈 素 清 、 张 泽 娜 、 王 晓 华 、 常 新 峰 、 林 龙 、 王 亚 
飞 、 薛 疾 、 王 刚 、 吴 贵 文 、 李 雷霆 ， 排 名 不 分 先后 。 


著 者 
2017 年 10 月 
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第 一 篇 
Node.js 概述 和 开发 环境 的 搭建 


本 篇 介绍 开发 Node.js 的 主要 特点 、 发 展 历史 和 开发 环境 的 搭建 ， 主 要 包括 Node.js 的 特 
性 、 应 用 场景 、 开 发 环境 的 措 建 以 及 开发 工具 的 选择 。 





Nodejs 是 一 个 基于 JavaScript 的 跨 平台 开发 语言 。 随 着 全 栈 开发 技术 的 不 断 推广 和 日 益 盛 
行 , Nodejs 逐渐 成 为 一 种 非常 流行 的 开发 语言 。 本 章 主要 对 Nodejs 进行 整体 介绍 ， 并 对 其 发 
展 历史 和 相关 版 本 进行 详细 的 说 明 ， 同 时 也 包含 在 今后 开发 中 所 涉及 的 基础 知识 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 


@ Nodejs 的 发 展 历史 和 特点 。 

@ V8 引擎 的 介绍 及 其 与 Node.js 之 间 的 关系 。 
@ Nodejs 的 一 些 应 用 场景 。 

@ Nodejs 在 中 国 的 发 展 及 相关 资源 。 


1 .| Node.js 简介 


Node.js 是 一 个 基于 Google 所 开发 的 浏览 器 Chrome V8 引擎 的 JavaScript 运 行 环境 Nodejs 
使 用 多 种 先进 的 技术 ， 其 中 包括 事件 驱动 、 非 阻塞 式 IO 模型 ， 使 其 轻 量 又 高 效 ， 受 到 众多 开 
发 者 的 追捧 。 

简单 来 说 ，Node.js 就 是 运行 在 服务 端的 JavaScript， 可 以 稳定 地 在 各 种 平台 下 运行 ， 包 括 
Linux、Windows、Mac OSX、SunOS 和 FreeBSD 等 众多 平台 。 

作为 Web 前 端 最 重要 的 语言 之 一 ，JavaScript 一 直 是 前 端 工程 师 的 专利 。 不 过 ，Nodejs 
是 一 个 后 端的 JavaScript 运行 环境 (支持 的 系统 包括 Linux、Windows) ， 这 意味 着 我 们 可 以 
编写 系统 级 或 者 服务 器 端的 JavaScript 代码 ， 交 给 Node.js 来 解释 执行 。 

简单 的 Nodejs 命令 类 似 于 : 


由 于 采用 V8 引擎 执行 JavaScript 的 速度 非常 快 , 因此 Nodejs 所 开发 出 来 的 应 用 程序 性 能 
非常 好 。Node.js 已 经 成 为 全 栈 开 发 的 首选 语言 之 一 ， 并 且 从 它 衍 生出 众多 出 色 的 全 栈 开发 杠 
架 。Node 已 经 在 全 球 被 众多 公司 使 用 ， 包 括 创业 公司 Voxer、Uber 以 及 沃尔玛 、 微 软 这 样 的 
知名 公司 。 它 们 每 天 通过 Node 处 理 的 请 求 数 以 亿 计 , 可 以 说 在 要 求 苛刻 的 服务 器 系统 , Nodejs 
也 可 以 轻松 胜任 。 


Node.js 还 包括 一 个 完善 的 社区 。 在 Node.js 的 官方 网 站 http://Node.js.cn/ 可 以 找到 大 量 的 
文档 和 示例 程序 ， 并 且 Nodejs 还 有 一 个 强大 的 包 管理 器 NPM。 渐 渐 地 ， 越 来 越 多 的 人 参与 
到 本 项 目 中 来 ， 可 用 的 第 三 方 模块 和 扩展 增长 迅猛 ， 而 且 质 量 也 在 不 断 提升 ，Node 已 是 全 球 
较 大 的 开源 库 生 态 系统 之 一 。 








二 Nodejs 不 是 一 个 JavaScript 应 用 ,而 是 一 个 JavaScript 的 运行 环境 ,由 CH+ 语 言 编写 而 成 。 | 








1】, 2 Nodejs 的 发 展 历史 和 特点 


任何 语言 或 框架 都 不 是 一 天 形成 的 , 而 是 经 过 漫长 的 测试 、 发 布 、 再 测试 、 再 发 布 的 迭代 
过 程 。 本 节 就 来 介绍 一 下 Nodejs 的 发 展 过 程 。 


1.2.1 Node.js 发 展 历史 


Node.js 的 创始 人 是 大 名 易 易 的 Ryan Dahl。 他 本 来 是 学 数学 的 ，2008 年 末 一 个 偶然 的 机 
会 让 他 了 解 到 Google 推出 了 一 个 新 的 浏览 器 Chrome 和 崭新 的 JavaScript 引擎 V8。 他 听 说 这 
是 一 个 为 了 更 快 的 Web 体验 而 专门 制作 的 更 快 的 JavaScript 引擎 , V8 能 够 让 Web 应 用 大 大 提 
速 。 当 时 , 他 正在 寻找 一 个 新 的 编程 平台 来 做 网 站 , 他 非常 希望 能 找到 一 种 语言 能 提供 先进 的 
推送 功能 并 集成 到 网 站 中 ， 而 不 是 采用 传统 的 方式 一 一 不 断 轮 询 拉 取 数 据 。 

Ryan Dahl 对 C/C++ 和 系统 调用 非常 熟悉 ， 他 使 用 系统 调用 (用 C) 实现 消息 推送 这 样 的 
功能 。 如 果 只 使 用 非 阻塞 式 Socket， 每 个 连接 的 开销 都 会 非常 小 。 在 小 规模 测试 中 ， 它 能 同时 
处 理 几 千 个 闲置 连接 ， 并 可 以 实现 相当 大 的 吞吐 量 。 但 是 ， 他 并 不 想 使 用 C， 他 希望 能 采用 另 
外 一 种 漂亮 灵活 的 动态 语言 。 他 最 初 也 希望 采用 Ruby 来 写 Node.js， 但 是 后 来 发 现 Ruby 虚拟 
机 的 性 能 不 能 满足 要 求 ， 后 来 便 尝 试 采 用 V8 引擎 ， 所 以 选择 了 C++ 语言 。 

2009 年 2 月 ，Ryan Dahl 首次 在 自己 的 博客 上 宣布 准备 基于 V8 创建 一 个 轻 量 级 的 Web 
服务 器 并 提供 一 套 库 ， 并 在 2009 年 5 月 正式 在 GitHub 上 发 布 最 初版 本 的 部 分 Nodejs 包 。 随 
后 几 个 月 里 ， 有 人 开始 使 用 Node.js 开发 应 用 。 实 践 证 明 ，JavaScript 与 非 阻塞 Socket 配合 得 
相当 完美 ， 只 需要 简单 的 几 行 JavaScript 代码 就 可 以 构建 出 非常 复杂 的 非 阻塞 服务 器 。 

2010 年 年 底 ，Nodejs 获得 云 计算 服务 商 Joyent 资助 。 创 始 人 Ryan Dahl 加 入 Joyent， 全 
职 负责 Nodejs 的 发 展 。Node.js 从 此 以 后 迅猛 发 展 ， 并 成 为 一 种 流行 的 开发 语言 。 

在 官方 网 站 上 Nodejs 的 版 本 号 是 从 0.1.14 开始 的 ， 每 个 发 布 版 本 对 应 不 同 的 V8 引擎 版 
本 和 NPM 包 管 理 器 版 本 ,截止 作者 写作 时 最 新 的 版 本 为 V6.11.0， 其 各 个 版 本 的 具体 发 布 时 
间 参 见 表 1-1 (2014 年 以 后 ) 。 
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表 1-1 NodeJjs 版 本 

















Node.js v6.11.0 2017-06-06 
Node.js v6.0.0 2016-04-26 
Node.js v5.0.0 2015-10-29 
Node.js v4.2.0 2015-10-12 
Node.js v4.0.0 2015-09-08, 











从 1x 到 3.x 的 版 本 之 间 Nodejs 的 名 称 曾经 被 修改 为 iojs， 后 来 iojs 的 全 部 代码 合并 到 
Nodejs 的 主干 发 布 版 本 。 




















Node.js 的 发 展 大 致 可 以 分 为 以 下 4 个 阶段 。 


(1) 发 展 初期 。 创 始 人 Ryan Dahl 带 着 他 的 团队 开发 出 以 Web 为 中 心 的 Web.js， 一 切 都 
非常 混乱 ，API 大 多 都 处 于 研究 阶段 。 

(2) 快速 发 展 时 期 。Node.js 的 核心 用 户 Isaac Z. Schlueter 开发 出 商定 了 Node.js 如 今 地 
位 的 重要 工具 一 一 NPM, 同 时 也 为 他 后 来 成 为 Ryan 接班 人 的 重要 条 件 。 之 后 Connect、Express、 
Socket.io 等 库 的 出 现 吸 引 了 一 大 波 爱 好 者 加 入 到 Node.js 开发 者 的 阵营 中 来 .CoffeeScript 的 出 
现 更 是 让 不 少 Ruby 和 Python 开发 者 找到 了 学 习 的 理由 。 其 间 一 大 波 以 Node.js 作为 运行 环境 
的 CLI 工具 涌现 ， 其 中 不 乏 用 于 加 速 前 端 开 发 的 优秀 工具 ， 如 Less、UglifyJS、Browserify、 
Grunt 等 。 这 个 阶段 Nodejjs 的 发 展 势如破竹 。 

(3) 不 稳定 时 期 。 经 过 了 一 大 批 一 线 工程 师 的 探索 实践 后 ，Node.js 开始 进入 时 代 的 更 迭 
期 ， 新 模式 代替 旧 模 式 ， 新 技术 代替 旧 技术 ， 好 实践 代替 旧 实 践 。ES 6 也 开始 出 现在 Nodejs 
世界 中 。ES 6 的 发 展 越 来 越 明 显 ，V8 也 对 ES 6 中 的 部 分 特性 实现 了 支持 ， 如 Generator 等 。 

(4) 稳步 发 展 时 期 。 随 着 ES 2015 的 发 展 和 最 终 定稿 ， 一 大 批 利 用 ES 2015 特性 开发 的 
新 模块 出 现 ， 如 原 Express 核心 团队 所 开发 的 Koa。Node.js 之 父 Ryan Dahl 退出 Node.js 的 核 
心 开 发 ， 转 而 做 其 他 的 研究 项 目 。Ryan Dahl 的 接任 者 Isaac Schlueter (也 是 Node.js 的 核心 构 
建 者 ) 将 Node.js 一 直 开发 下 去 并 不 断 完 善 。 








1.2.2 Node.js 未 来 版 本 规划 


Nodejjs 的 核心 团队 已 经 为 Node.js 的 长 远 发 展 做 好 了 详细 计划 。 图 1.1 是 Nodejs 到 2018 
年 为 止 的 所 有 版 本 计划 及 发 布 时 间 表 。 
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图 1.1 计划 及 发 布 时 间 表 


1.2.3 NodeJjs 的 结构 


前 面 介绍 了 Node.js 是 一 个 完整 的 JavaScript 开发 环境 ,并且 是 基于 Google 的 Chrome V8 
引擎 进行 代码 解释 的 。 它 在 设计 之 初 就 已 经 定位 用 来 解决 传统 Web 开发 语言 所 遇 到 的 诸多 问 
题 ， 所 以 Node.js 有 很 多 其 他 开发 语言 所 不 具备 的 优点 ， 包 括 事件 驱动 、 异 步 编程 等 。 下 面 我 
们 先 介绍 一 下 Node.js 的 结构 ， 然 后 详细 分 析 Nodejs 的 一 些 主要 特点 。 

图 1.2 中 浅 绿色 的 部 分 是 由 JavaScript 编写 的 ， 深 绿色 的 是 由 C/C++ 完成 的 。 从 图 1.2 中 


可 以 看 出 来 ，Nodejs 的 结构 大 致 分 为 以 下 3 个 层次 。 


@ ”Nodejs 标准 库 , 这 部 分 是 由 JavaScript 编写 的 , 即 我 们 使 用 过 程 中 直接 能 调用 的 API。 


在 源码 中 的 lib 目录 下 可 以 看 到 。 


@ ”Node bindings。 这 一 层 是 JavaScript 与 底层 C/C++ 能 够 沟通 的 关键 ,前 者 通过 bindings 


调用 后 者 ， 相 互 交换 数据 。 


@ 支撑 Nodejs 运行 的 基础 构件 。 这 层 内 容 比 较 多 ， 下 面 详 细 介绍 。 
支撑 Nodejs 运行 的 基础 构件 是 由 C/C++ 实 现 的 ， 其 中 包括 4 大 部 分 。 


@@ V8: Google 推出 的 JavaScript VM， 也 是 Node.js 为 什么 用 JavaScript 的 关键 ， 它 为 
JavaScript 提供 了 在 非 浏 览 器 端 运行 的 环境 ， 它 的 高 效 是 Node.js 之 所 以 高 效 的 原 


因 之 一 


@ libuv: 为 Nodejs 提供 了 跨 平 台 、 线 程 池 、 事 件 池 、 异 步 IO 等 能 力 ， 是 Node.js 如 


此 强大 的 关键 。 
@ 。 C-ares: 提供 了 异步 处 理 DNS 相关 的 能 


®@ http_ parser、OpenSSL、zlib 等 : 提供 包括 HTTP 解析 、SSL、 数 据 压缩 等 能 
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Node standard library 
http,net,stream,fs,events,buffer.… 





图 1.2 Nodejs 的 结构 


1.2.4 NodeJjs 的 特点 


都 说 Nodejs 强大 ， 这 种 强大 体现 在 很 多 方面 ， 如 事件 驱动 、 异 步 处 理 、 非 阻塞 IO 等 。 
这 里 将 介绍 Node.js 具备 的 不 同 于 其 他 框架 的 特点 。 


1. 事件 驱动 


在 某 些 传统 语言 的 网 络 编程 中 ， 我 们 会 用 到 回调 函数 ， 比 如 当 Socket 资源 达到 某 种 状态 
时 ， 注 册 的 回调 函数 就 会 执行 。Node.js 的 设计 思想 中 以 事件 驱动 为 核心 ， 它 提供 的 绝 大 多 数 
API 都 是 基于 事件 的 、 异 步 的 风格 。 以 Net 模块 为 例 ， 其 中 的 net.Socket 对 象 就 有 以 下 事件 : 
connect、data、end、timeout、drain、error、close 等 。 使 用 Nodejs 的 开发 人 员 需 要 根据 自己 
的 业务 逻辑 注册 相应 的 回调 函数 。 这 些 回调 函数 都 是 异步 执行 的 。 这 意味 着 虽然 在 代码 结构 中 
这 些 函 数 看 似 是 依 次 注册 的 ,但 是 它们 并 不 依赖 于 自身 出 现 的 顺序 , 而 是 等 待 相应 的 事件 触发 。 

事件 驱动 的 优势 在 于 充分 利用 了 系统 资源 , 执行 代码 无 须 阻塞 等 待 菜 种 操作 完成 , 有 限 的 
资源 可 以 用 于 其 他 的 任务 。 此 类 设计 非常 适合 于 后 端的 网 络 服 务 编程 ，Node.js 的 目标 也 在 于 
此 。 在 服务 器 开发 中 , 并 发 的 请 求 处 理 是 一 个 大 问题 , 阻塞 式 的 函数 会 导致 资源 浪费 和 时 间 延 
人 述 。 通 过 事件 注册 、 异 步 函 数 ， 开 发 人 员 可 以 提高 资源 的 利用 率 ， 性 能 也 会 改善 。 


2. 异步 、 非 阻塞 /O 


从 Nodejs 提供 的 支持 模块 中 ， 我 们 可 以 看 到 包括 文件 操作 在 内 的 许多 函数 都 是 异步 执行 
的 。 这 和 传统 语言 存在 区 别 。 为 了 方便 服务 器 开发 ，Node.js 的 网 络 模块 特别 多 ， 包 括 HTTP、 
DNS、NET、UDP、HTTPS、TLS 等 。 开 发 人 员 可 以 在 此 基础 上 快速 构建 Web 服务 器 。 

一 个 异步 IO 的 大 致 流程 如 图 1.3 所 示 ， 讲 解 如 下 : 


(1) 发 起 IO 调用 
@ 用 户 通过 JavaScript 代码 调用 Node 核心 模块 ， 将 参数 和 回调 函数 传 入 核心 模块 。 
@ Node 核心 模块 会 将 传 入 的 参数 和 回调 函数 封装 成 一 个 请 求 对 象 。 
@ 将 这 个 请 求 对 象 推 入 IO 线程 池 等 待 执行 。 





@ JavaScript 发 起 的 异步 调用 结束 ，JavaScript 线程 继续 执行 后 续 操 作 。 


(2) 执行 回调 
@ IO 操作 完成 后 会 将 结果 储存 到 请 求 对 象 的 result 属性 上 ， 并 发 出 操作 完成 的 通知 。 
@ 每 次 事件 循环 时 会 检查 是 否 有 完成 的 IO 操作 ， 如 果 有 就 将 请 求 对 象 加 入 IO 观察 者 
队列 中 ， 之 后 当 作 事 件 处 理 。 
@ 处 理 IO 观察 者 事件 时 会 取出 之 前 封装 在 请 求 对 象 中 的 回调 函数 , 执行 这 个 回调 函数 ， 
并 将 result 当 作 参 数 ， 以 完成 JavaScript 回调 的 目的 。 


Node.js 的 网 络 编程 非常 方便 ， 提 供 的 模块 〈 在 这 里 是 HTTP) 开放 了 容易 上 手 的 API 接 
口 ， 短 短 几 行 代码 就 可 以 构建 服务 器 。 
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图 1.3 异步 IO 的 流程 


3. 性 能 出 众 


创始 人 Ryan Dahl 在 设计 的 时 候 就 考虑 了 性 能 方面 的 问题 ， 选 择 C++ 和 V8， 而 不 是 Ruby 
或 者 其 他 的 虚拟 机 。Node.js 在 设计 上 以 单 进程 、 单 线程 模式 运行 。 事 件 驱动 机 制 是 Nodejs 
通过 内 部 单线 程 高 效率 地 维护 事件 循环 队列 来 实现 的 ， 没 有 多 线程 的 资源 占用 和 上 下 文 切换 。 
这 意味 着 面 对 大 规模 的 HTTP 请 求 ，Nodejs 是 凭借 事件 驱动 来 完成 的 。 从 大 量 的 测试 结果 分 
析 来 看 ，Node.js 的 处 理性 能 是 非常 出 色 的， 在 qps 达到 16700 次 时 ， 内 存 仅 占用 30MB 〈 测 
试 环境 : RHEL 5.2、CPU 2.2GHz、 内 存 4GB) 。 


4. 单线 程 
Node.js 和 大 名 易 易 的 Nginx 一 样 , 都 是 以 单线 程 为 基础 的 。 这 正 是 Node.js 保持 轻 量 级 和 
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高 性 能 的 关键 , 也 是 Ryan Dahl 设计 Nodejs 的 初衷 。 这 里 的 单线 程 是 指 主线 程 为 “单线 程 ”， 
所 有 阻塞 的 部 分 交 给 一 个 线程 池 处 理 , 然后 这 个 主线 程 通过 一 个 队列 跟 线 程 池 协 作 。 我 们 写 的 
js 代码 部 分 不 用 再 关心 线程 问题 ， 代 码 也 主要 由 一 堆 callback 回调 构成 ， 然 后 主线 程 在 循环 过 
程 中 适时 调用 这 些 代 码 。 

单线 程 除 了 保证 Node.js 高 性 能 之 外 ， 还 保证 了 绝对 的 线程 安全 ， 使 开发 者 不 用 担心 同一 
变量 同时 被 多 个 线程 读 写 而 造成 的 程序 崩溃 。 





1.2.5 ”Nodejs 的 应 用 场景 


Node.js 的 可 以 应 用 到 很 多 方面 ， 可 以 说 从 Node.js 开始 程序 员 们 可 以 使 用 JavaScript 来 
发 服务 器 端的 程序 了 。Nodejs 为 前 端 开发 程序 员 们 提供 了 便利 ， 并 在 各 大 网 站 中 承担 重要 角 
色 ， 成 为 开发 高 并 发 大 型 网 络 应 用 的 关键 技术 。Web 站 点 早已 不 仅 限于 内 容 的 呈现 ， 很 多 交 
互 性 和 协作 型 环境 也 逐渐 被 搬 到 了 网 站 上 , 而 且 这 种 需求 还 在 不 断 地 增长 。 这 就 是 所 谓 的 数据 
密集 型 实时 (data-intensive real-time) 应 用 程序 ， 比 如 在 线 协 作 的 白板 、 多 人 在 线 游 戏 等 ， 这 
种 Web 应 用 程序 需要 一 个 能 够 实时 响应 大 量 并 发 用 户 请 求 的 平台 支撑 它们 ， 这 正 是 Nodejs 
擅长 的 领域 。 此 外 ，Node.js 的 跨 平台 特性 也 是 使 用 Node.js 语言 开发 流行 的 另 一 大 原因 。 

Node.js 的 主要 应 用 场景 如 下 : 


@ JSON APIs 一 一 构建 一 个 Rest/JSON API 服务 ，Nodejs 可 以 充分 发 挥 其 非 阻塞 IO 模 
型 以 及 JavaScript 对 JSON 的 功能 支持 (如 JSON.stringfy 函数 ) 。 

@ 单 页 面 、 多 Ajax 请 求 应 用 一 一 如 Gmail， 前 端 有 大 量 的 异步 请 求 ， 需 要 服务 后 端 有 
极 高 的 响应 速度 。 

@ 基于 Nodejs 开 发 UNIX 命令 行 工 具 一 一 Node.js 可 以 大 量 生 产子 进程 , 并 以 流 的 方式 
输出 ， 这 使 得 它 非常 适合 做 UNIX 命令 行 工具 。 

@ 。 流 式 数据 一 一 传统 的 Web 应 用 ,通常 会 将 HTTP 请 求 和 响应 看 成 原子 事件 , 而 Nodejs 
会 充分 利用 流 式 数据 这 个 特点 , 构建 非常 酷 的 应 用 ,如 实时 文件 上 传 系统 transloadit。 

@ 准 实 时 应 用 系统 如 聊天 系统 、 微 博 系统 ， 但 JavaScript 是 有 垃圾 回收 机 制 的 ， 这 
就 意味 着 系统 的 响应 时 间 是 不 平滑 的 ( GC 垃圾 回收 会 导致 系统 这 一 时 刻 停止 工作 ) 。 
如 果 想 要 构建 硬 实时 应 用 系统 ，Erlang 是 一 个 不 错 的 选择 。 


例如 ， 实 时 互动 交互 比较 多 的 社交 网 站 ， 像 Twitter 这 样 的 公司 ， 它 必须 接收 tweets 并 将 
其 写 入 数据 库 。 实 际 上 ， 每 秒 几 乎 有 数 千 条 tweet 达到 ， 数 据 库 不 可 能 及 时 处 理 高 峰 时 段 所 需 
的 写 入 数量 。Node 成 为 这 个 问题 解决 方案 的 重要 一 环 。Node 能 处 理 数 万 条 入 站 tweet。 它 能 
快速 而 又 轻松 地 将 它们 写 入 一 个 内 存 排队 机 制 (例如 memcached) ， 另 一 个 单独 进程 可 以 从 
那里 将 它们 写 入 数据 库 。Node 能 处 理 每 个 连接 而 不 会 阻塞 通道 ， 从 而 能 够 捕获 尽 可 能 多 的 
tweets 。 

虽然 看 起 来 Nodejs 可 以 做 很 多 事情 , 并 且 拥 有 很 高 的 性 能 , 但 是 Nodejs 并 不 是 万 能 的 ， 
有 一 些 类 型 的 应 用 ，Nodejs 可 能 处 理 起 来 会 比较 吃力 。 例 如 ，CPU 密集 型 的 应 用 、 模 板 泻 染 、 
压缩 /解压 缩 、 加 /解密 等 操作 都 是 Nodejs 的 软肋 。 

















下 .本 ”Nodejs 在 中 国 的 发 展 


Node.js 在 初期 发 展 的 时 候 ， 国 内 就 有 大 量 的 开发 者 开始 持续 关注 了 。 随 着 Nodejjs 的 
不 断 成 熟 ， 很 多 国内 的 公司 都 开始 采用 这 一 新 技术 。2013 年 、2014 年 、2015 年 的 JS 中 
国 开发 者 大 会 都 将 Node.js 作为 一 个 主要 的 宣讲 内 容 , Node.js 也 被 国内 的 开发 爱好 者 所 追 
捧 。Node.js 开发 者 在 国内 的 数量 不 断 增 加 ， 并 涌现 出 很 多 组 织 和 机 构 来 自发 地 进行 推广 

国内 的 各 大 视频 培训 网 站 上 都 有 Node.js 开发 的 培训 教程 ， 各 大 门户 网 站 也 都 或 多 或 少 地 
采用 了 Node.js 的 开发 技术 ， 淘 宝 、 网 易 、 百 度 等 有 很 多 项 目 运行 在 Node.js 之 上 。 阿 里 云 是 
在 这 方面 比较 靠 前 的 公司 ， 它 们 的 云 平台 率先 支持 Nodejs 的 开发 。 淘 宝 也 为 Node.js 搭建 了 
国内 的 NPM 镜像 网 站 ， 方 便 国 内 的 开发 者 下 载 各 种 开发 包 。 












































1.3.1 ”Node.js 中 文 资源 汇总 

(1) Nodejs 官方 网 站 , 是 Node.js 在 国内 的 官方 网 站 ， 有 关于 Node.js 最 新 版 本 的 下 载 和 
新 闻 ， 丰 富 的 文档 资料 非常 值得 认真 学 习 ， 是 Node.js 开发 爱好 者 不 容错 过 的 网 站 ， 网 址 为 
http://Node.js.cn/。 

(2) CNode 社区 ， 由 一 批 热 爱 Node.js 技术 的 工程 师 发 起 , 已 经 吸引 了 互联 网 各 个 公司 
的 专业 技术 人 员 加 入 ， 是 目前 国内 非常 具有 影响 力 的 Node.js 开源 技术 社区 ， 致 力 于 Nodejs 
的 技术 研究 ， 并 有 论坛 会 定期 组 织 一 些 技术 交流 活动 ， 网 址 为 https://cNode.js.org。 

(3)Nodejs 中 文 网 , 是 一 个 专业 的 Node.js 中 文 知识 分 享 社区 , 致力 于 普及 Node.js 知识 ， 
分 享 Node.js 研究 成 果 ， 努 力 推进 Node.js 在 中 国 的 应 用 和 发 展 ， 网 站 有 大 量 的 技术 博客 和 文 
章 ， 各 个 级 别 的 开发 者 都 能 找到 适合 自己 学 习 的 资料 ， 网 址 为 WWW.Node.js.Net。 

(4) 淘宝 NPM 镜像 ， 是 一 个 完整 npmjs.org 镜像 ， 可 以 用 此 代替 官方 版 本 ， 同 步 频率 为 
每 10 分 钟 一 次 ， 以 保证 尽量 与 官方 服务 同步 ， 网 址 为 https://npm.taobao.org/。 

(5) Nodejs & HTML5 论坛 ， 也 是 一 个 学 习 Nodejs 和 前 端 开发 技术 非常 好 的 网 站 ， 每 
天 都 有 大 量 原创 文章 发 布 ， 并 且 技 术 问题 可 以 很 快 被 回答 。 当 然 , 如 果 愿 意 为 其 他 人 解答 技术 
问题 或 者 进行 技术 分 享 也 是 非常 欢迎 的 。 其 网 址 为 http://forjs.org/。 

每 年 的 JS 中国 开 发 者 大 会 和 各 种 Node.js 分 享 沙龙 也 都 是 很 好 的 学 习 Node.js 开发 技术 和 

交流 的 机 会 。 一 个 开发 者 要 时 刻 保持 谦虚 的 心态 ， 并 不 断 学 习 最 新 的 技术 。 这 对 开发 者 来 说 
是 一 种 基本 能 力 和 素养 。 

















1.3.2 ”NodeJjs 的 发 展 和 未 来 


Node.js 虽然 在 创建 之 初 是 为 了 开发 即时 通信 的 Web 应 用 ， 当 然 现在 的 Nodejs 已 绝 不 只 
是 一 套 简单 的 Web 堆栈 一 一 作为 一 项 技术 ， 它 在 多 个 层面 焕发 出 勃勃 生机 ， 价 值 已 经 远 远 超 
出 了 常见 Web 服务 器 的 范畴 。 
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例如 , 一 款 由 Jacob Groundwater 打造 的 项 目 叫 NodeOS, 其 创始 人 希望 围绕 Linux 核心 建 
立 起 一 套 新 型 环境 。 其 中 ，Nodejs 作为 “shel1”， 而 Node 的 NPM 则 被 用 于 系统 包 管 理 器 。 
到 目前 为 止 ，NodeOS 的 首 个 版 本 已 经 创建 完成 。Nodejs 还 被 用 来 作为 硬件 控制 的 工具 替代 
C/C++，Noduino 允许 大 家 经 由 WebSocket 或 者 串 连接 实现 Arduino 访问 。 该 项 目 虽 尚 处 于 起 
步 阶段 ， 但 驱动 主板 上 的 LED 模块 、 捕 捉 来 自 Arduino 的 事件 〈 例 如 按 下 按钮 ) 等 常见 功能 
都 已 可 以 正常 支持 ， 以 后 就 可 以 通过 网 页 直接 控制 Arduino 硬件 和 其 他 物 联网 设备 了 。 
2016 年 Node.js 发 布 了 两 个 重量 级 的 版 本 v4.4.0 LTS (长 期 支持 版 本 ) 和 v5.9.0 Stable ( 稳 
定 版 本 )， 并且 成 立 了 Node.js 基金 会 , 能够 让 Node.js 在 未 来 有 更 好 的 开源 社区 支持 。Nodejs 
基金 会 的 创始 成 员 包 括 Joyent、IBM、Paypal、 微 软 、Fidelity 和 Linux 基金 会 。Node.js 的 core 
(核心 ) 已 经 非常 稳定 并 逐步 被 广大 开发 者 所 认可 ， 进 行 大 规模 使 用 。 著 名 的 Nodejs 包 管 
理工 具 NPM 在 2014 年 成 为 软件 开发 世界 中 包 管 理工 具 的 龙头 老大 , 现在 NPM 包含 的 模块 数 
是 Java 以 及 Ruby 的 包 管 理工 具 模块 数目 的 两 倍 ! 图 1.4 反映 了 NPM 包 管 理工 具 的 增长 情况 。 


Module Counts 
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1.4 NPM 包 管理 工具 的 增长 情况 


发 数据 来 源 http://www.modulecounts.com/。 | 


2017 年 上 半年 Nodejs 和 NPM 的 普及 率 进一步 提升 。 大 公司 对 Node.js 的 应 用 持续 提升 ， 
并 推出 更 多 对 企业 级 友好 功能 的 长 期 计划 ， 可 能 预示 着 Nodejs 在 企业 中 会 持续 增长 ， 蔡 换 一 
部 分 在 企业 中 像 Java 和 .NET 这 样 的 典型 解决 方案 。Node.js 诞生 于 2009 年 ， 其 年 龄 远 不 如 
Python、Ruby、PHP 等 老牌 开发 语言 ， 但 是 它 成 为 有 史 以 来 发 展 最 快 的 开发 工具 。 可 以 预见 ， 
在 未 来 的 几 年 Node.js 技术 会 不 断 发 展 起 来 ， 成 为 Web 开发 的 核心 技术 ， 并 从 现 有 的 Java、 
PHP 等 语言 中 争夺 到 更 多 的 份额 。 
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1 4， 温 帮 知 新 


学 完 本 章 中 ， 读 者 需要 回答 : 


1. Node.js 有 哪 几 大 主要 特性 ? 
2. 在 选择 Node.js 开发 的 时 候 有 哪些 注意 事项 ? 


第 2 章 
< 部 置 Node .js 开发 环境 > 


部 署 Node.js 的 开发 环境 是 开始 正式 接触 Nodejs 的 第 一 步 。Node.js 可 以 在 多 个 不 同 的 平 
台 稳 定 运 行 ， 并且 具 有 良好 的 兼容 性 。 但 是 Node.js 部 署 在 不 同 操作 系统 下 的 方法 并 不 完全 一 
致 ， 本 章 主 要 介绍 如 何在 各 个 操作 系统 平台 下 进行 Node.js 的 部 署 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 

@ Windows 部 署 : 学 会 如 何在 Windows 操作 系统 上 安装 Node.js。 
Linux 部 署 : 学 会 在 各 种 Linux 发 行 版 本 上 部 署 Node.js 开发 环境 。 
Mac OS X 部 署 : 学 会 在 Mac 的 OSX 系 统 上 部 署 Node.js 开发 环境 。 
树 莓 派 3 部 署 : 学 习 如 何 使 用 nvm 在 树苗 派 3 上 部 署 Node.js 开发 环境 。 
开发 工具 介绍 : 介绍 Sublime Text 3 的 使 用 方法 和 Node.js 插件 的 安装 。 


Windows 10 下 部 署 Node.js 开发 环境 


Node.js 可 以 在 Windows 系统 下 稳定 运行 , 本 节 主 要 介绍 Windows 10 下 的 Node.js 环境 部 
署 。 在 Windows 中 进行 Node.js 环境 部 署 是 相对 比较 简单 的 ， 首 先 从 Nodejs 的 官方 网 站 
Chttps:/nodejs.org/en/download/) 上 下 载 最 新 的 Windows 安装 包 ， 国 内 用 户 可 以 通过 Nodejs 
官方 中 文 站 点 http://nodejs.cn/download/ 进 行 下 载 。 中 文 站 点 的 下 载 页 面 和 英文 版 的 布局 略 有 不 
同 , 中 文 版 只 提供 最 新 发 布 版 本 的 下 载 , 而 英文 站 点 同时 提供 最 新 稳定 版 本 和 最 新 版 本 两 个 版 
本 的 下 载 链接 。 











属 元 Nodejs 的 其 他 发 布 版 本 可 以 从 https:/nodejs.org/dist/ 链 接 找 到 , 本文 以 v6.2.0 在 Windows 
\ 10 进行 安装 为 例 。 











Node.js 的 安装 包 在 Windows 平台 分 为 installer 和 Binary 两 个 版 本 。installer 是 通常 的 安 
装 包 发 布 版 本 〈.msi) 。Binary 为 二 进 制版 本 ， 可 以 下 载 后 直接 运行 (.exe) 。 这 里 建议 使 用 
后 缀 为 .msi 的 安装 版 本 。 此 外 ，Nodejs 的 安装 包 分 为 32 位 和 64 位 ， 在 下 载 的 时 候 请 查看 系 
统 的 具体 信息 ， 并 选择 正确 的 安装 包 进 行 下 载 和 安装 。 

打开 下 载 网 站 的 界面 , 如 图 2.1 所 示 。 读 者 根据 系统 选择 , 比如 笔者 选择 64 位 的 Windows 
系统 ， 下 载 的 是 node-v6.2.0-x64.msi。 








€ 3 © [Bhttps//nodejs org/en/download 








Downloads 


Download the Nodejs source code or a pre-built installer for your platform, and start developing today. 


% 证 


Windows Installer Macintosh Installer Source Code 








Current 


Latest Features 











Windows Installer ms)) 2 bt 
Windows Binary (.exe) Rb br 
Mac OS XInstaller (.pkg) 

Mac OS X Binaries (tar.gz) 


Linux Binaries (tar.xz) 








ps/fnodeis orm/des A S/node vA -x64 ma 


图 2.1 Nodejs 官方 网 站 下 载 页 面 








如 果 选 择 Nodejs 之 前 的 版 本 ， 可 以 在 官方 网 站 中 找到 Previous Releases 链接 ， 然 后 查找 
| 需要 的 版 本 号 。 








2.1.1 ”使 用 安装 包 进 行 Node.js 安装 


(1) 安装 包 下 载 完 之 后 是 一 个 10MB 大 小 的 后 级 名 为 msi 的 安装 文件 ， 双 击 下 载 后 的 安 
装 包 文件 ， 首 先 弹出 询问 界面 ， 如 图 2.2 所 示 。 单 击 图 2.2 中 的 Run (运行 按钮 会 出 现 欢 迎 
界面 ， 直 接 单 击 Next 按钮 进入 下 一 步 。 


Open File - Security Warning —— 





Do you want to run this file? 


器 | Name: E\download\node-w0.10.26-x86.msi 
Publsher Joyent Inc 


Type: Windows Installer Package 
From: E\downloadnode-w0.10.26-86.msl 


Rm ] 
司 Always ask before opening this fie 


Weties fromthe hemet con be orkut thie the ype oon 
O 上 your computer Only run software from publshers 
' emt 











图 2.2 Nodejs 安装 步骤 -1 


(2) 出 现 图 2.3 所 示 的 界面 。 色 选 接受 协议 选项 后 Next 按钮 会 变 为 可 用 状态 ， 单 击 Next 
按钮 进入 下 一 步 。 
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1 End-User License Agreement 


| lease resd the folowing hcense agreement carefay nede 由 













copyright Joyent, Inc. and other Node contributors Al rights 
Ireserved. Permission is hereby granted, free of charge, to any person 
lobtaining a copy of this software and associated documentation files 
[he "sofwaren to deal in the Software without restriction, induding 
ithout limitation the rights to use, copy, modify, merge, publish, 

distribute, sublicense, and/or sell coples of the Software, and to 
permit persons to whom the Software is furnished to do so, subject 
hn the fnlnwinn rnndinnns' 


laccept the terms in the License Agreement 


Bm) md) 
| Bs 
图 2.3 Nodejs 安装 步骤 -2 


(3) 此 时 打开 Nodejs， 默 认 安装 目录 为 C:\Program Files\nodejs\， 如 图 2.4 所 示 。 我 们 既 
可 以 通过 Change 按钮 修改 目录 ， 又 可 以 直接 单 击 Next 按钮 。 





























EE x | 
Destination Folder 


at nede 


Instal Node-s to; 





EWrogrom Fics rodep\ 


[ge ] 





Ce Ce Ce 





图 2.4 Nodejs 安装 步骤 -3 


(4) 单 击 Next 按钮 后 出 现 图 2.5 所 示 的 自 定义 安装 界面 ， 我 们 选择 默认 设置 即 可 。 单 击 
Next 按钮 后 会 出 现 一 个 准备 安装 界面 ， 然 后 单 击 准备 安装 界面 中 的 Install 按钮 。 


期 Nodejs Setup 





和 t=. mE 
Custom Setup 
enter nede 


Chck the icons in the tree below to change the way features wl be instaled 





























Roset | Dekusooe | Bak J mex J ce | 











图 2.5 Nodejs 安装 步骤 -4 


(5) 开始 安装 的 界面 如 图 2.6 所 示 。 安 装 需要 等 待 1 分 钟 左 右 ， 安 装 完成 后 出 现 完成 界 
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面 ， 单 击 Finish 按钮 就 完成 了 安装 。 


FT 













Teina Wodess nedes 





Please wait whie the Setup Wizard nstals Node -js 


Status: ”Updating component regstration 
ee 














Cm ne ] Eee 





图 2.6 Nodejs 安装 步骤 -5 


(6) 安装 好 后 系统 默认 的 环境 变量 PATH 是 C:\Documents and Settings\Administrator\ 
Application Datampm， 也 可 以 根据 需要 手动 修改 本 地 的 安装 目录 ， 并 将 全 局 目录 设置 为 与 本 地 
初始 默认 安装 目录 一 致 。 在 完成 安装 Node.js 的 时 候 默 认 也 安装 了 NPM。NPM 是 Node.js 的 
包 管 理工 具 ， 在 后 面 的 章节 进行 介绍 。 





到 #PATH 六 量 ,过 要 右 击 计算 机 ,选择 “属性 ” |“ 高 级 系统 属性 ”选项 ,打开 “系统 
一 属性 ”对话 框 。 然 后 单 击 “ 高 级 "| “环境 变量 ” 选项 ， 在 “用 户 变量 ”列表 项 中 找到 PATH 
变量 ， 单 击 下 方 的 “编辑 ”按钮 就 可 以 看 到 所 有 赤 量 在 这 里 的 设置 ， 主 要 是 设置 路 径 。 








2.1.2 测试 Node.js 开发 环境 


安装 Node.js 开发 环境 成 功 之 后 创建 一 个 简单 的 APP 来 测试 Node.js 是 否 能 够 正常 运行 。 

首先 ， 为 APP 创建 一 个 目录 。 在 D 盘 根 目 录 下 新 建 一 个 名 为 projects 的 目录 ， 然 后 在 其 
中 创建 一 个 名 为 NodeApp 的 子 目 录 。 在 NodeApp 目录 里 面 创建 一 个 名 为 hello_world.js 的 js 
文件 ， 然 后 在 hello_world.js 中 写 入 如 下 代码 。 


【示例 2-1】 





【代码 说 明 】 
上 面 的 代码 是 一 个 简单 的 Nodejs Web 服务 举例 。 它 在 电脑 上 创建 一 个 HTTP Web 服务 ， 
并 在 网 页 上 打印 出 Hello World 字符 串 。 通 过 Windows 开始 菜单 | Node.js | Node.js command 
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prompt 来 运行 Node.js。Node.js command prompt 是 


-个 命令 行 界面 ， 用 来 启动 Nodejs 编译 环 
党 。 如 果 在 开始 菜单 里 找 不 到 Node.js command prompt， 可 以 在 搜索 框 中 输入 node， 然 后 找到 
它 并 运行 。 


因为 默认 打开 的 路 径 不 是 我 们 创建 项 目的 路 径 ， 所 以 这 里 我 们 可 以 通过 cd 命令 来 切换 路 径 : 
DA # 切 换 到 D 盘 


cd D:\projects\NodeApp # 切 换 到 项 目 路 径 


接 下 来 运行 hello_world.js， 简 单 地 输入 如 下 node 命令 


node hello world.js 


如 果 一 切 都 顺利 ， 那 么 我 们 将 会 在 command prompt 中 看 到 : 


Server running at http://localhost:3000/ 
如 图 2.7 所 示 。 


丽 管理 员 : Nodejs command prompt - node hello_worldjs 


nent has been set up for using Node.js 6.2. 


projects\NodeApp’node 


hello_world.js 
ng at http: 


localhost :3888/ 





图 2.7 Nodejjs 命令 行 运行 界面 
入 如 下 URL: 
http://localhost:3000/ 


然后 打开 浏览 器 输 


接着 会 在 浏览 器 中 看 到 “Hello World”， 如 图 2.8 所 示 。 这 
且 能 成 功 运行 Node.js 程序 。 


说 明 Node 平台 安装 成 功 ， 并 











localhost 
全 The ructed source 





i 





图 2.8 ”Hello world 程序 运行 结果 


Linux 下 部 署 Node.js 开发 环境 


在 Linux 下 安装 Node.js 有 很 多 种 方法 ,常见 的 方法 有 通过 包 管 理 器 安装 Node.js、 源 码 安 
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装 。 下 面 针 对 各 种 版 本 的 Linux 和 安装 方法 进行 介绍 。 
2.2.1 通过 源码 安装 Node.js 


下 面 以 Ubuntu 14.04 为 例 说 明 如 何 使 用 源码 安装 Nodejs。 
(1) 首先 ， 通 过 下 面 的 命令 安装 版 本 工具 。 


(2) 其 次 ， 新 建 一 个 目录 ， 并 使 用 wget 命令 下 载 Nodejs 源码 。 


或 者 通过 git 直接 从 GitHub 上 复制 。 


(3) 最 后 配置 安装 选项 并 进行 编译 安装 ， 其 中 X 代表 服务 器 的 CPU 数量 。 


安装 成 功 后 ， 可 以 使 用 node - Y 命令 来 检查 Nodejs 的 版 本 以 及 是 否 安装 成 功 。 


画 Nodejs 选择 下 载 源码 进行 编译 安装 之 前 ， 要 确保 系统 安装 了 Python 2.6 或 2.7。 


2.2.2 ”通过 包 管 理 器 安装 Node.js 

在 Linux 的 不 同 版 本 下 可 以 使 用 NPM 进行 Node.js 安装 。 下 面 仅 列举 几 种 常见 的 Linux 
发 布 版 的 方法 。 

1. Arch Linux 

在 Arch Linux 中 Nodejs 和 NPM 包 是 全 面 支持 的 ， 可 以 通过 一 条 指令 进行 安装 : 





2. 基 于 Debian 和 Ubuntu 的 Linux 发 布 版 


基于 Debian 和 Ubuntu 的 Linux 发 布 版 本 主要 包括 Linux Mint、Linux Mint Debian Edition 
(LMDE) 和 elementaryOS， 可 以 通过 Debian 和 Ubuntu 的 社区 NodeSource 来 下 载 和 安装 ， 
在 GitHub 上 的 链接 地 址 是 https://github.com/nodesource/distributions。 需 要 注意 的 是 ， 通 过 
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nodesource 安装 的 版 本 可 能 并 不 是 最 新 的 。 
@ 安装 Nodejs4x 版 本 的 方法 如 下 : 


@ 安装 nodejs v6 版 本 的 方法 如 下 : 


3.Red Hat Enterprise Linux/RHEL、CentOS 和 Fedora 


在 Red Hat、CentOS 和 Fedora 上 使 用 NPM 安装 Node.js 的 时 候 需 要 修改 对 应 的 地 址 ， 具 
体 版 本 的 链接 可 能 略 有 不 同 。 要 使 用 root 用 户 登录 ， 并 执行 下 面 的 命令 : 


@ 4x 版 本 


@ 6.x 版 本 


然后 使 用 yum 命令 来 安装 Nodejs: 


在 Fedora 18 之 后 的 版 本 ，Nodejs 和 NPM 是 默认 支持 的 ， 只 需要 通过 下 面 的 一 条 命令 就 
可 以 安装 : 


2.3 Macosx 下 部 署 Node.js 开发 环境 


在 OS X 上 安装 有 3 种 方式 ， 即 使 用 源码 安装 、 使 用 NPM 包 管理 器 安装 和 使 用 安装 包 安 
装 。 本 节 主 要 介绍 如 何 使 用 .dmg 安装 包 和 NPM 包 管理 器 进行 安装 。 
2.3.1 使 用 .dmg 安装 包 进 行 安装 


首先 从 Nodejs 官方 网 站 上 下 载 最 新 的 OSX 安装 包 ， 并 按照 安装 向 导 进 行 安装 ， 界 面 如 
图 2.9 所 示 。 


Node.js 开发 实战 


【2 重 Install Node a 
The installation was completed successtully. 





本 放生 本 下 Node was installed at 

® License /usr/local/bin/node 

® Destination Select pm was installed at 

Installation Type 

/usr/local/bin/npm 

Summary Make sure that /usr/local/bin is in your SPATH. 


图 2.9 在 OSX 下 安装 Nodejs 
安装 之 后 ，/usr/local/bin 在 环境 变量 中 已 经 定义 ， 如 果 没 有 就 在 当前 用 户 home 目录 下 
的 .bash_profile 或 者 .bashrc 中 进行 添加 。 
2.3.2 使 用 NPM 包 管 理 器 安装 


使 用 NMP 包 管 理 器 安装 Node.js 时 要 从 Nodejs 的 官方 网 站 上 下 载 最 新 的 Macintosh 
Installer。 可 以 通过 curl 执行 下 面 的 命令 来 安装 : 


或 者 使 用 MacPorts 执行 下 面 的 代码 : 


.4， 树 莫 派 3 下 使 用 NVM 安装 Nodejs 
树 莓 派 是 一 款 卡片 式 的 学 习 电脑 ， 由 英国 剑桥 大 学 在 2012 年 3 月 首发 。 本 节 主 要 介绍 如 
何在 树 莓 派 3 的 官方 操作 系统 Raspbian 上 使 用 NVM 安装 Nodejs。 


(1) 首 先 下 载 和 安装 NVMChttps:/github.com/creationixnvm) NVM 的 全 称 是 Node Version 
Manager (Nodejs 版 本 管理 器 ) ， 它 可 以 让 我 们 在 各 个 Node.js 版 本 之 间 进 行 灵 活 的 切换 。 


(2) 然后 使 用 nano 命令 编辑 .bashrc 和 .profile， 在 文件 未 尾 增加 source ~/nvm/nvm.sh， 
并 重新 启动 树 莓 派 ， 具 体 命 令 如 下 : 
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sudo nano ~/.bashrc 
sudo nano ~/.profile 


sudo reboot 
(3) 启动 完成 后 ， 在 shell 里 面 执行 nvm 命令 。 当 看 到 输出 时 ， 表 示 NVM 安装 成 功 。 
nvm --version 
(4) 现在 开始 安装 Nodejs。 使 用 nvm 命令 安装 Nodejs 稳定 版 ， 如 v0.12.3。 
$ nvm install 0.12.3 
(5) 安装 完成 后 ， 可 以 使 用 下 列 代 码 进行 查看 。 
$ nvm 1s 


这 时 可 以 看 到 自己 安装 的 所 有 Node.js 版 本 。 


使 用 NPM 进行 Node 包 的 安装 


前 面 我 们 已 经 很 多 次 使 用 NPM 命令 了 ， 这 其 实 使 用 的 是 Nodejs 默认 的 包 管理 器 NPM。 
当 Node.js 安装 完成 后 ， 也 默认 将 NPM 安装 完成 。 安 装 包 模 块 使 得 Node.js 变 成 了 一 个 更 加 强 





250000 个 不 同 的 包 可 供 开 发 者 下 载 使 用 ， 网 址 为 https://www.npmjs.com/。 
例如 ， 我 们 希望 在 Nodejs 上 扩展 一 个 MySQL 接口 ， 可 以 让 我 们 在 App 中 使 用 MySQL 
数据 库 。 只 需要 在 Nodejs command prompt 中 输入 如 下 命令 即 可 : 


npm install mysqgl 





上 面 的 命令 会 通过 NPM 下 载 和 安装 MySQL Node 包 。 当选 择 的 包 安 装 完成 时 会 看 到 如 图 
2.10 所 示 的 信息 。 





图 2.10 使 用 NPM 在 Windows 下 安装 MySQL 包 


NPM 的 常用 命令 介绍 如 下 : 
(1) 查看 帮助 


npm help 或 npm h 
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(2) 安装 模块 


(3) 在 全 局 环境 中 安装 模块 〈-g: 启用 global 模式 ) 


更 多 的 内 容 可 参考 https://npmjs.org/doc/install.html。 
(4) 印 载 模块 


(5) 显示 当前 目录 下 安装 的 模块 


























Nodejs 安装 成 功 后 ， 系 统 会 自动 在 PATH 用 户 环境 变量 和 系统 环境 中 分 别 添加 NPM 和 
Nodejs 路 径 。 








2.6 开发 TI 具 介绍 


为 了 更 高 效 地 编写 Node.js 代码 ， 需 要 使 用 一 个 好 的 编辑 器 ， 这 里 推荐 大 家 使 用 Sublime 
Text。Sublime Text 是 一 款 具 有 代码 高 亮 、 语 法 提示 、 自 动 完成 且 反 应 快速 的 编辑 器 软件 。 它 
主要 有 以 下 两 大 优点 : 


@。 跨 平 台 : Sublime Text 3 为 跨 平台 编辑 器 ， 可 以 在 Windows、OS X 和 Linux 下 安装 。 
开发 人 员 在 开发 和 测试 的 时 候 切换 系统 是 常 有 的 事情 ， 为 了 减少 重复 学 习 ， 使 用 一 个 
跨 平 台 的 编辑 器 是 很 有 必要 的 。Sublime Text 3 可 以 使 你 的 开发 工作 在 各 个 系统 之 间 
进行 无 颖 切换 。 

@ 可 扩展 : Sublime Text3 包含 大 量 实用 插件 ， 可 以 通过 安装 自己 领域 的 插件 来 成 倍 提 
高 工作 效率 。 


Sublime Text 有 Sublime Text 2 和 Sublime Text3 两 个 版 本 。 它 们 的 界面 大 致 相同 ， 但 是 
Sublime Text 3 的 启动 速度 很 快 ， 而 且 支 持 更 多 的 功能 ， 所 以 本 书 以 Sublime Text 3 为 例 进行 
介绍 。 

2.6.1 下 载 安装 Sublime Text 3 


Sublime Text 3 beta 版 本 已 经 非常 稳定 了 ， 官 方 下 载 网 址 为 http://www.sublimetext.com/3。 
需要 注意 的 是 Sublime Text3 是 付费 软件 ， 虽 然 可 以 无 限期 地 进行 试用 ， 但 是 如 果 长 期 使 用 建 
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议 还 是 购买 正版 的 序列 号 激活 。 
(1) 打开 下 载 界面 ， 如 图 2.11 所 示 。64 位 的 Windows 系统 请 选择 “Windows 64 bit” 安 


装 包 即 下 载 文 件 为 “Sublime Text Build 3114x64 Setup.exe” 的 安装 程序 。“portable version” 
下 载 下 来 为 “Sublime Text Build 3114 x64.zip” 编 辑 器 的 包 ， 解 压 后 无 须 安装 就 能 运行 。 


Sublime Text 3 


Download 


Sublime Text 3 is currently in beta. The latest build is 3114. 


T 




















oo OSX (10.7 or later is required) 

。 Windows - also available as a portable version 

。 Windows 64 bit - also available as a portable version 

。 Ubuntu 64 bit - also available as a tarball for other Linux distributions. 
。 Ubuntu 32 bit - also available as a tarball for other Linux distributions. 





Sublime Text may be downloaded and evaluated for free, however a license must be 
purchased for continued use. There is currently no enforced time limit for the 
evaluation. 


For notification about new verslons, follow sublimehq on twitter 
Even more bleeding-edge versions are available in the dev builds 


Sublime Text 2 |s also still avallable. 
图 2.11 Sublime Text3 官方 下 载 页 面 


(2) 双击 上 一 步 下 载 下 来 的 安装 包 ， 并 按照 提示 进行 安装 ， 如 图 2.12 所 示 。 


刘 Setup - Sublime Text 3 一 X 





Welcome to the Sublime Text 3 
Setup Wizard 
This will install Sublime Text Build 3114 on your computer, 


Itis recommended that you dose all other applications before | 
continuing， 


Click Next to continue, or Cancel to exit Setup. 


图 2.12 Sublime Text3 安装 过 程 


(3) 安装 成 功 后 ， 双 击 桌面 上 的 “Sublime Text 3” 快 捷 图 标 ， 就 可 以 打开 Sublime Text 3 
程序 了 。 
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如 果 是 OS X 或 者 是 Ubuntu 就 下 载 相应 的 安装 包 ， 并 参照 安装 说 明 进行 操作 。 如 果 是 在 
Linux 下 安装 ， 就 先 使 用 uname -mm 命令 查看 操作 系统 的 类 型 ， 再 选择 合适 的 安装 包 。 








2.6.2 


Sublime Text 操作 界面 


Sublime Text 的 界面 如 图 2.13 所 示 。 





图 2.13 Sublime Text3 操作 界面 
界面 中 的 各 种 操作 选项 说 明 如 下 : 


标签 (Tab ) : 分 别 显示 每 个 打开 的 文件 。 

编辑 区 ( Editing Area ) : 主要 编辑 文本 内 容 的 区 域 ， 位 于 界面 的 中 心 位 置 。 

侧 栏 (Side Bar) : 包含 当前 打开 的 文件 以 及 文件 夹 视图 。 

缩 略图 (Minimap ) : 当前 打开 文件 的 缩 略图 。 

命令 板 (Command Palette ) : Sublime Text 的 操作 中 心 ， 使 我 们 基本 可 以 脱离 鼠标 和 
菜单 栏 进行 操作 。 

控制 台 ( Console ) : 使 用 Ctrl + ` 快 捷 键 可 以 调 出 该 窗口 。 它 既是 一 个 标准 的 Python 
REPL， 也 可 以 直接 对 Sublime Text 进行 配置 。 

状态 栏 (Status Bar ) : 显示 当前 行 号 、 当 前 语言 和 Tab 格式 等 信息 。 








区 元 Sublime Text 3 的 相关 操作 文档 和 使 用 说 明 在 https://www.sublimetext.com/docs/3/ 上 。 | 
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2.6.3 安装 Sublime Text 3 插件 


Sublime Text 3 最 强大 的 功能 就 是 针对 各 种 开发 语言 的 编辑 插件 。 为 了 安装 和 管理 这 些 插 
件 ,我们 首先 需要 安装 包 管 理 器 (package control) ， 官 方 首页 链接 为 https://packagecontrol.io。 
通过 Ctrl+' 快 捷 键 或 者 在 菜单 中 选择 View | Show Console 来 打开 控制 台 , 然后 将 下 面 的 代码 粘 
贴 到 控制 台中 运行 。 





这 段 代 码 将 创建 一 个 安装 包 的 目录 ， 并 将 包 控 制 器 Package Control.sublime-package 下 载 
到 这 个 目录 中 。 安 装 完毕 后 ， 需 要 重新 启动 Sublime Text 3 。 


2.6.4 安装 Node.js 插件 


在 Package Control 首页 的 搜索 框 输入 nodejs， 就 可 以 查找 到 所 有 和 Nodejs 相关 的 包 ， 如 
图 2.14 所 示 。 可 以 看 到 由 tanepiper 创建 的 Nodejs 包 是 当下 最 热门 的 Nodejs 插件 ， 下 载 量 为 
156000 次 。 


Package Control [NODE | 


fillers. :5t2 :5t3 :win :o 





SORTBY Relevance Popuanty 


NodeEVal by mediaupstream ED 3K INSTALLS 
A Sublime Text Plugin that "evals" a selection/document with NodeJS 





Nodejs by tanepiper, varp OTOP100 156K INSTALLS 
nodejs snippets and bindings for Sublime Text 2 











NodeRequirer by ganemone SK INSTALLS 
A Sublime Text 3 plugin for requiring modules. 


nodejsLauncher py diestmn 14K INSTALLS 
Launch the file with node js. 
Node Completions pyjames2doyle 30K INSTALLS 


A collection of completetions/snippets for node js v5 x 


JavaScript & Nodejls SNippets by zenorocha 82K INSTALLS 
JavaScript & NodeJS Snippets for Sublime Text 2/3 


io Node Framework byjustindoo0 [CI 1K INSTALLS 
io Node Sublime 


图 2.14 ”Package Control 包 搜索 和 下 载 页 面 
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打开 Node.js 包 的 链接 ， 我 们 可 以 看 到 这 个 包 的 详细 介绍 和 使 用 方法 ， 并 且 可 以 查看 到 这 


个 包 每 月 的 下 载 量 。 


@ 在 MaC OSX 下 的 安装 命令 是 : 


@ 在 Windows 下 的 安装 命令 是 : 


@ 在 Linux 下 的 安装 命令 是 : 


2.6.5 Sublime Text 3 快捷 键 


按照 类 型 可 以 把 快捷 键 分 为 编辑 、 选 择 、 查 找 & 替 换 、 跳 转 、 窗 口 、 屏 幕 。 这 里 分 别 对 党 


用 的 快捷 键 做 一 个 简单 介绍 。 


1. 编辑 


@ CtrltEnter: 在 当前 行 下 面 新 增 一 行 ， 然 后 跳 至 该 行 。 

@ CtritShifttEnter: 在 当前 行 上 面 增加 一 行 并 跳 至 该 行 。 

@ Ctrl+ 和 二 /一 : 进行 逐 词 移动 。 

@ CtrltShiftt /一 : 进行 逐 词 选择 。 

@ Ctrit1/1: 移动 当前 显示 区 域 。 

@ CtrlHShifttT /14 : 移动 当前 行 。 

2. 选择 

@ Ctrl+D: 选择 当前 光标 所 在 的 词 并 高 亮 该 词 所 有 出 现 的 位 置 ， 再 次 按 Ctrl+D 快捷 键 
选择 该 词 出 现 的 下 一 个 位 置 。 在 多 重 选 词 的 过 程 中 ， 使 用 Ctrl+K 快捷 键 进行 跳 过 ， 
使 用 Ctrl+U 快捷 键 进行 回 退 ， 使 用 Esc 键 退出 多 重 编辑 。 

CtrltShifttL: 将 当前 选中 区 域 打 散 。 

CtrltJ: 把 当前 选中 区 域 合并 为 一 行 。 

CtrlHM: 在 起 始 括号 和 结尾 括号 间 切 换 。 

CtrltShifttrM: 快速 选择 括号 间 的 内 容 。 

Ctrl+Shift+J: 快速 选择 同 缩 进 的 内 容 。 

Ctrl+Shift+Space: 快速 选择 当前 作用 域 (Scope ) 的 内 容 。 

. 查找 & 蔡 换 


Cn 


© ~ eee 


Seeeeeeeen77eeeee ”"” @ @ 
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F3: 跳 至 当前 关键 字 下 一 个 位 置 。 

ShifttF3: 跳 到 当前 关键 字 上 一 个 位 置 。 

Alt+F3: 选中 当前 关键 字 出 现 的 所 有 位 置 。 
CtrlHF/H: 进行 标准 查找 /替换 ， 之 后 : 

> AlttC: 切换 大 小 写 敏感 ( Case-sensitive ) 模式 。 
> AlttW: 切换 整 字 匹 配 ( Wholematching ) 模式 。 
> AlttR: 切换 正则 匹配 (Regexmatching ) 模式 。 
CtrlHShift+H: 替换 当前 关键 字 。 

Ctrl+Alt+Enter: 替换 所 有 关键 字 匹 配 。 
CtrltShifttF: 多 文件 搜索 && 蔡 换 。 


跳 转 


Ctrl+P: 跳 转 到 指定 文件 ， 输 入 文件 名 后 可 以 再 输入 以 下 内 容 。 
> @ 符 号 ; 跳 转 输入 ， 如 @symbol 跳 转 到 symbol 符号 所 在 的 位 置 。 
> # 关 键 字 : 跳 转 输入 ， 如 才 eyword 跳 转 到 keyword 所 在 的 位 置 。 
> : 行 号 : 跳 转 输入 ， 如 :12 跳 转 到 文件 的 第 12 行 。 
Ctrl+R: 跳 转 到 指定 符号 。 
Ctrl+G: 跳 转 到 指定 行 号 。 

窗口 
CtrlHShifttN: 创建 一 个 新 窗口 。 
CtrlHN: 在 当前 窗口 创建 一 个 新 标签 。 
Ctrl+W: 关闭 当前 标签 ， 当 窗口 内 没有 标签 时 会 关闭 该 窗口 。 
Ctrl+Shift+T: 恢复 刚刚 关闭 的 标签 。 

屏幕 
F11: 切换 至 普通 全 屏 。 
ShifttF11: 切换 至 无 干扰 全 屏 。 
Alt+Shiftt1Single: 切换 至 独 屏 。 
Alt+ShiftH2Columns:2: 切换 至 纵向 二 栏 分 屏 。 
AlttShiftt3Columns:3: 切换 至 纵向 三 栏 分 屏 。 
Alt+Shiftt4Columns:4: 切换 至 纵向 四 栏 分 屏 。 
Alt+Shiftt8Rows:2: 切换 至 横向 二 栏 分 屏 。 
Alt+Shiftt9Rows:3: 切换 至 横向 三 栏 分 屏 。 
Alt+Shiftt5Grid: 切换 至 四 格式 分 屏 。 


学 


2 .7 温 故 知 新 


学 完 本 章 后 ， 读 者 需要 回答 : 

1. Windows 10 下 安装 Nodejs 有 哪 几 种 方式 ? 

2. 如 何 使 用 NPM 下 载 特定 的 Nodejs 开发 包 ? 

3. Node.js 在 Windows 中 的 默认 安装 路 径 是 什么 ? 

4. 在 Sublime Text 3 中 使 用 什么 快捷 键 可 以 新 建 一 个 文档 ? 
5. Node.js 支持 哪些 操作 系统 ? 
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本 篇 介绍 Nodejs 常用 原生 模块 的 开发 基础 ， 主 要 包括 Nodejjs 的 包 管 理 、 模 块 机 制 以 及 
Node.js 开发 中 最 常用 的 文件 模块 、 网 络 开发 模块 、 数 据 库 开 发 模块 等 知识 。 


第 3 章 
< Node.js 开 发 基山 > 


Node.js 是 建立 在 V8 引擎 之 上 的 , 也 就 意味 着 Nodejs 的 语法 几乎 与 JavaScript 语法 一 致 。 
这 也 是 Nodejs 大 受 前 端 开 发 人 员 欢 迎 的 原因 ， 即 通过 一 门 语言 便 可 打通 前 后 端 开 发 。 在 这 
i 介绍 JavaScript 的 基本 使 用 ， 为 之 后 Node.js 的 学 习 提 供 必 要 的 基础 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 

@ JavaScript 的 基础 语法 与 使 用 。 

@ 了 解 简单 的 JavaScript 编程 风格 。 

@ 了 解 基本 的 Nodejs 控制 台 的 使 用 。 


Javascript 语 ; 


JavaScript 是 一 门 直译 式 、 弱 类 型 的 脚本 语言 ,也 是 Web 开发 最 重要 的 语言 之 一 .JavaScript 
由 ECMAScript、DOM (文档 对 象 模型 ) 、BOM (浏览 器 对 象 模型 ) 三 部 分 组 成 。ECMAScript 
规定 了 JavaScript 的 语法 核心 ， 这 也 是 本 节 重 点 介绍 的 内 容 。 


3.1.1 变量 


1. 交互 式 运行 环境 一 一 REPL 


Nodejs 提供 了 一 个 交互 式 运 行 环 境 一 一 REPL。 在 这 个 交互 式 环境 中 可 以 运行 简单 的 应 用 
程序 。 在 控制 台 直 接 输入 node 即 可 进入 这 个 环境 ， 此 时 控制 台 会 显示 一 个 “>” 符 号 ， 表 明 
我 们 已 经 进入 这 个 环境 ， 如 图 3.1 所 示 。 








图 3.1 进入 REPL 运行 环境 

















本寺 | 如 果 要 退出 该 运行 环境 ， 连 续 按 两 次 CtrltC 快捷 键 ， 或 者 输入 .exit。Nodejs 的 命令 需要 
在 前 面 加 点 。 例 如 ， 可 用 -help 查看 所 有 命令 。 
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本 节 中 的 所 有 代码 都 会 在 这 个 环境 中 使 用 和 运行 。 
2. 浏览 器 环境 一 一 Chrome 


当然 ， 读 者 也 可 以 在 浏览 器 的 控制 台 运行 。 以 Chrome 浏览 器 为 例 ， 通过 使 用 F12 键 或 者 
Ctrl+ Shift+1I 快 捷 键 打开 开发 者 工具 ， 在 开发 者 工具 栏 中 选择 Console 面板 ， 如 图 3.2 所 示 。 
在 Console 中 也 是 显示 一 个 “>” 符 号 ， 和 REPL 的 使 用 方法 一 致 。 


民 所 | Bements Console Sources Network Timeline Profles Application Securty Audits 
@ 如 top 目 preserveieg 


> 





3.2 浏览 器 的 Console 面板 


3. 关键 字 var 


JavaScript 的 变量 通过 关键 字 var 来 声明 。 前 面 说 过 JavaScript 是 一 门 弱 类 型 的 编程 语言 ， 
JavaScript 的 所 有 数据 类 型 都 可 以 用 var 关键 字 来 声明 , 通过 var 变量 名 = 值 的 形式 就 可 以 对 变 
量 同 时 进行 声明 和 赋值 。 和 许多 语言 一 样 ，JavaScript 通过 分 号 “;” 来 分 隔 不 同 的 语句 ， 以 下 
这 段 代码 就 声明 了 两 个 变量 : 


4. 变量 的 命名 

JavaScript 规定 变量 名 必须 以 字母 、 美 元 符 ($)、 下 划 线 (_) 三 者 之 一 开头 , 同时 JavaScript 
对 大 小 写 敏感 ， 大 小 写 不 同 也 就 意味 着 是 不 同 的 两 个 变量 。 同 时 ，JavaScript 不 区 分 单 引号 与 
双 引 号 ， 因 此 上 一 个 例子 与 用 单 引号 表示 的 效果 一 致 : 


5. 变量 提升 机 制 


JavaScript 中 存在 变量 提升 机 制 ， 也 就 是 所 有 的 变量 声明 在 运行 时 都 会 提升 到 代码 的 最 前 
方 。 例 如 ， 上 个 例子 在 运行 时 实际 上 会 先 声明 两 个 变量 再 赋值 : 


通过 一 个 更 直观 的 例子 或 许 会 让 读者 更 易 理 解 变 量 提升 。 在 REPL 中 试图 使 用 一 个 未 声明 
的 变量 时 会 出 现 is not defined 错误 ， 如 图 3.3 所 示 。 





图 3.3 变量 未 声明 错误 


如 果 试 图 使 用 一 个 已 经 声明 却 未 赋值 的 变量 ， 那 么 这 个 变量 所 代表 的 是 undefined， 如 图 
3.4 所 示 。 


> var a;console. log(a); 





图 3.4 已 经 声明 却 未 赋值 


量 直 | 图 3.4 中 有 两 行 undefined: 一 个 是 白色 ， 一 个 是 半 透 明白 色 。 执 行 node 语句 ， 在 没有 任何 返回 值 
[ 的 时 候 总 是 会 输出 一 个 undefined， 读 者 不 必 介 意 ， 这 不 是 错误 。 白 色 语句 是 正常 输出 的 内 容 。 





使 用 一 个 在 后 来 定义 赋值 的 代码 时 会 返回 undefined， 如 图 3.5 所 示 。 


> console. 1og(a)jivar a = 10; 
undefined 


图 3.5 先 使 用 后 声明 赋值 

可 以 发 现 这 段 代 码 返回 undefined 正 是 因为 变量 提升 ， 实 际 运行 的 代码 如 下 : 
Var a; 
console.1log(a); 
a= 10; 
3.1.2 注释 

JavaScript 中 的 注释 和 很 多 其 他 编程 语言 类 似 ， 以 双 斜 本 〈/) 代表 单行 注释 ， 以 “/* 注 释 
内 容 */” 形 式 代表 多 行 注释 。 
// 这 是 单行 注释 
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3.1.3 ”数据 类 型 


JavaScript 中 的 数据 类 型 可 以 分 为 简单 数据 类 型 和 复杂 数据 类 型 。 简 单数 据 类 型 有 
undefined、boolean、number、string、null， 复 杂 数 据 类 型 只 有 object。object 由 一 组 无 序 的 键 
值 对 组 成 。 


1. 利用 typeof 区 分 数据 类 型 


利用 操作 符 typeof 可 以 部 分 区 分 以 上 数据 类 型 。typeof 返回 的 值 有 undefined、boolean、 
number、string、object 和 function。 下 面 举 一 个 例子 。 


【示例 3-1】 





【代码 解析 】 
可 以 看 到 null 和 object 都 返回 了 object， 这 是 因为 null 实际 上 是 一 个 空 对 象 指针 ， 当 一 个 
变量 只 声明 未 赋值 时 返回 undefined。 
number 和 string 数据 类 型 分 别 指数 字 类 型 和 字符 串 类 型 ，boolean 类 型 和 其 他 语言 一 样 ， 
仅 有 true 和 false 两 个 值 ， null 仅 有 一 个 值 null。 
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2. 利用 Boolean() 转 化 数据 类 型 


JavaScript 中 可 以 利用 Boolean() 方 法 将 其 他 数据 类 型 转化 为 布尔 值 。 需 要 注意 的 是 ， 空 字 
符 串 、0、null、undefined、NaN 都 将 转化 为 false， 其 他 值 则 会 转化 为 tue。 下 面 举 一 个 例子 。 


【示例 3-2】 





3.1.4 函数 


在 JavaScript 中 ,声明 一 个 函数 只 需要 使 用 function 关键 字 即 可 , 如 声明 一 个 求 和 的 函数 ， 
代码 如 下 : 





当然 ， 函 数 同样 可 以 作为 一 个 值 传 递 给 一 个 变量 ， 例 如 : 





调用 一 个 函数 同样 很 简单 ,只 需要 在 函数 声明 之 后 使 用 “函数 名 (参数 )” 的 形式 调用 即 可 ， 
如 调用 上 面 的 函数 : 
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函数 中 默认 带 有 一 个 arguments 对 象 ， 这 是 一 个 类 数组 对 象 。arguments 记录 了 传递 给 函 
数 的 参数 信息 , 因为 javascript 中 的 函数 调用 时 , 参数 个 数 并 不 需要 和 定义 函数 时 的 个 数 一 致 。 
在 上 面 的 add0 方 法 中 多 添加 几 个 参数 ， 函 数 仍然 会 正常 执行 ， 例 如 : 





利用 好 这 一 点 和 arguments 类 数组 特性 可 以 对 上 述 的 add 方法 拓展 一 下 ， 让 这 个 函数 无 论 
接收 多 少 个 参数 ， 总 能 返回 这 些 数 值 的 和 : 





还 可 以 利用 JavaScript 中 的 arguments 类 数组 对 象 模拟 函数 重 载 。 当 然 ， 实 际 上 JavaScript 
并 不 支持 函数 重 载 ， 比 如 通过 检测 arguments 对 象 的 length 属性 做 出 不 同 的 反应 来 模拟 重 载 。 
下 面 给 出 一 个 完整 的 例子 。 


【示例 3-3】 





} 


return sum; 


} 
operate(3, 4); 
WA I2 
operate(3, 4, 5); 
pa ae be 
以 上 代码 的 运行 效果 如 图 3.6 所 示 。 
D: \projectsnode 


> function ope 
Cargunen 


teC) 
ength == 2》《 


return arguments[B] x argunents[1]; 


} else € 
var sun 
forCvar i 8. 
Sum += arguments[i]3 
》 


return sum; 


> operate(3。 4. 5); 


> 


图 3.6 运行 效果 
【代码 解析 】 
arguments 对 象 是 
个 真正 的 数组 ， 这 样 就 可 以 使 用 数组 的 所 有 方法 ， 
function funName () { 


Var arguments = [].slice.call (arguments); 


// the code of function 


3.1.5 闭 包 
JavaScript 中 的 变量 可 以 分 为 全 局 变量 
而 函数 外 音 





局 变量 


信里 ， 





var str = 'node.js'; 
function copy () { 
var str2 = str; 


console.log(str2); 


并 不 能 读 取 到 函数 内 部 定义 的 变量 ， 


max = arguments.length; i < max; i++> € 





-个 类 数组 对 象 ,通过 数组 的 slice() 方 法 可 以 把 arguments 对 象 转化 为 
而 不 用 担心 出 现 其 他 问题 了 。 


和 局 部 变量 。JavaScript 中 的 函数 自然 可 以 读 取 到 全 


例如 : 
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当然 ， 这 需要 在 定义 变量 的 时 候 使 用 var 关键 字 定 义 。 不 用 var 关键 字 定 义 的 话 ， 实 际 上 
这 个 变量 会 成 为 全 局 对 象 的 一 个 属性 。 在 Nodejs 中 ， 全 局 对 象 是 global， 如 果 上 面 代码 中 的 
str2 变量 不 使 用 var 定义 ，str2 就 会 成 为 一 个 全 局 变量 ,函数 外 部 也 是 可 以 读 取 到 这 个 变量 的 ， 
例如 : 





强 建议 所 有 的 变量 都 使 用 var 关键 字 进 行 定义 ， 以 避免 不 必要 的 错误 出 现 。 


JavaScript 中 的 闭 包 可 以 让 函数 读 取 到 其 他 函数 内 部 的 变量 ， 如 下 代码 就 可 以 让 函数 之 外 
读 取 到 函数 内 部 定义 的 变量 ， 这 就 是 最 简单 的 闭 包 。 


【示例 3-4】 





以 上 就 是 JavaScript 的 简要 介绍 。 更 多 关于 JavaScript 的 知识 ， 读 者 可 以 阅读 相关 的 书籍 
进行 学 习 和 掌握 。 进 行 Node.js 的 学 习 之 前 ， 读 者 应 该 对 JavaScript 有 一 定 的 了 解 。 
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可 .2 命名 规范 与 编程 规范 


与 其 他 语言 相 比 ，JavaScript 总 是 显得 相对 灵活 ， 对 代码 的 格式 要 求 也 显得 相对 宽松 ， 
此 对 JavaScript 编码 制定 一 定 的 规范 是 非常 重要 的 。 一 个 良好 的 规范 不 仅 能 让 阅读 代码 的 人 感 
到 清晰 愉悦 ， 还 能 让 整个 项 目 更 加 容易 维护 。 

3.2.1 命名 规范 


JavaScript 作为 一 种 弱 类 型 的 语言 ， 命 名 的 规范 显得 更 加 重要 ， 因 为 开发 人 员 并 不 能 直接 
看 出 这 个 变量 的 作用 。 


1. var 关键 字 


在 JavaScript 中 ， 所 有 的 变量 都 应 该 通过 var 关键 字 来 定义 ， 而 不 是 缺少 var 关键 字 ， 
为 缺少 var 的 变量 声明 会 使 得 这 个 变量 成 为 全 局 变量 ， 在 开发 中 则 应 尽量 减少 全 局 变量 : 


2. 驼峰 命名 法 


在 开发 中 , 变量 的 命名 常常 是 让 开发 人 员 头 疼 的 问题 , 一 般 来 说 每 个 团队 都 会 有 自己 的 命 
名 规范 。 近 些 年 来 更 加 流行 的 是 驼峰 命名 法 。 如 它 的 名 字 一 样 ， 驼 峰 命 名 法 中 第 一 个 单词 的 开 
头 小 写 ， 其 他 单词 的 开头 字符 大 写 ， 例 如 : 


3. 常量 


在 其 他 语言 中 ， 会 有 常量 这 样 一 个 概念 。 这 是 一 种 不 允许 在 声明 赋值 之 后 再 修改 的 变量 。 
显然 ，JavaScript 中 有 着 同样 的 需求 。 在 开发 人 员 不 希望 有 些 变量 得 到 修改 时 ， 常 量 就 显得 格 
外 重要 了 。 例 如 ， 定 义 一 个 圆周 率 的 常量 。 

在 常量 的 命名 中 ， 开 发 人 员 往 往 采用 变量 名 全 部 大 写 的 方式 来 表示 这 是 一 个 常量 。 当 然 ， 
实际 上 , 这 样 的 变量 依旧 是 可 以 被 修改 的 。 这 需要 开发 人 员 共同 遵守 规定 ,把 这 样 一 个 变量 作 
为 一 个 常量 ， 而 不 是 普通 的 JavaScript 变量 : 


CD 
© / 
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4. 内 部 变量 

开发 中 还 有 一 类 就 是 内 部 变量 .这 类 变量 并 不 希望 局 部 作用 域 之 外 的 作用 域 来 获取 这 些 变 
量 。 开 发 人 员 通 常 以 下 划 线 “” ”开头 命名 作为 约定 俗 成 的 内 部 变量 。 当 然 ， 这 同样 需要 协同 
的 开发 人 员 共 同 遵守 这 个 约定 : 





5. 有 意义 的 名 字 


命名 规范 中 同样 需要 遵守 的 是 , 在 命名 中 不 应 该 使 用 一 些 无 意义 的 变量 名 。 这 些 无 意义 的 
变量 名 往往 会 使 开发 人 员 摸 不 着 头脑 ,变量 的 命名 应 该 是 一 些 有 意义 的 、 能 够 表示 变量 作用 的 ， 
而 不 是 一 些 无 意义 、 混 淆 视听 的 变量 名 。 


3.2.2 ”编程 规范 


在 JavaScript 中 编程 规范 的 遵守 会 使 得 整个 项 目 得 到 更 快 的 开发 和 更 好 的 项 目 维护 同时 ， 
也 可 以 让 代码 看 起 来 更 加 优雅 易 读 。 


1. 以 分 号 结尾 
在 JavaScript 代码 中 ,所 有 的 语句 都 应 该 以 分 号 结尾 ， 虽 然 JavaScript 中 并 没有 强制 要 求 : 





2. 大 括号 


JavaScript4E2D 的 所 有 语句 块 都 应 该 有 大 括号 , 比如 一 个 简单 的 让 判断 语句 块 里 面具 有 一 
行 时 ， 不 使 用 大 括号 并 不 会 出 现 错误 ， 但 是 这 往往 会 让 开发 人 员 产 生 疑 惑 : 
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相等 判断 中 应 该 尽量 使 用 绝对 等 于 “= 一 ”， 因 为 等 于 “==” 存 在 着 类 型 转化 ， 这 在 开发 
中 可 能 会 出 现 意 想不到 的 错误 。 例如， 使 用 一 来 判断 null 与 undefined 时 会 出 现 true 的 情况 ， 
而 使 用 绝对 等 于 一 = 则 不 会 : 





4. 空格 的 使 用 


关于 JavaScript 中 的 空格 ， 永 远 不 要 音 亩 ， 因 为 满 屏 连续 的 字符 串 会 让 人 头疼 。 建 议 在 数 
值 操作 符 ( 如 +、-、*、/、% 等 ) 前 后 留 有 一 个 空格 ， 在 赋值 操作 符 和 相等 判断 中 前 后 留 有 一 
个 空格 。 在 json 对 象 中 键 值 对 的 冒号 后 应 该 留 有 一 个 空格 ， 如 以 下 的 空格 会 让 代码 在 开发 人 
员 的 眼中 更 加 优雅 : 


关于 JavaScript 中 的 注释 ,永远 记 住 一 条 : 所 有 的 注释 都 应 该 是 有 意义 的 ， 无 意义 的 注释 
只 会 让 阅读 代码 的 人 员 感 到 更 加 困惑 。 





关于 JavaScript 中 的 编程 规范 就 简单 介绍 到 这 里 。 相 比 于 别人 介绍 的 规范 ， 拥 有 一 套 属于 
自己 团队 内 部 的 使 用 规范 并 且 让 开发 人 员 遵守 这 个 规范 则 更 加 重要 。 
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Node.js 的 控制 台 console 


利用 好 Nodejs 提供 的 console 控制 台 和 debug 可 以 有 效 地 辅助 开发 和 定位 bug。 在 Nodejs 
中 ，console 代表 控制 台 ， 可 以 通过 console 对 象 的 各 种 方法 向 控制 台 进行 标准 输出 。 
3.3.1 console 对 象 下 的 各 种 方法 


在 REPL 交互 式 运 行 环 境 中 输入 console, 可 以 看 到 console 对 象 下 各 种 方法 组 成 的 一 个 数 
组 ， 如 图 3.7 所 示 。 





图 3.7 console 对 象 的 方法 


3.3.2 ”console.log() 方 法 

console.log() 方 法 用 于 标准 输出 流 的 输出 ， 也 就 是 在 控制 台中 显示 一 行 信息 ， 例 如 : 
console.log('node.js is Powerful') 

无 论 是 在 RPEL 环境 中 运行 这 行 代码 还 是 作为 Node.js 文件 执行 这 行 代 码 ， 都 可 以 看 到 控 
制 台 输出 了 “node.js is powerful” 字 样 。 

console.log() 方 法 并 没有 对 参数 的 个 数 进行 限制 ， 当 传递 多 个 参数 时 ， 控 制 台 输出 时 将 以 
空格 分 隔 这些 参 数 ， 例 如 : 
console.log('node.js','is','powerful'); 

运行 之 后 ， 同 样 会 在 控制 台 输 出 “nodejs is powerful” 字 样 ， 这 三 个 单词 也 依旧 是 以 空格 
分 隔 开 来 的 。 

console.log() 方 法 也 可 以 利用 占 位 符 来 定义 输出 的 格式 ， 如 %d 表示 数字 、%s 表示 字符 串 。 











如 果 需 要 对 后 面 的 多 个 参数 都 定义 格式 ,就 要 逐个 设置 ,并 且 输出 时 将 不 会 再 以 空格 分 隔 ; 
e 如 果 没有 预定 义 格式 ， 就 将 正常 输出 。 














示例 如 下 代码 : 


console.log('%s%s', 'node.js', ‘is', 'powerful'); 
// node.jsis powerful 
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在 这 一 段 代 码 中 ， 需 要 注意 的 是 当 使 用 %d 占 位 符 后 ， 如 果 对 应 的 参数 不 是 数字 ， 控 制 台 
将 会 输出 NaN。 
3.3.3 console.info()、console.warn() 和 console.error() 方 法 


console.info()、console.warn() 以 及 console.error() 的 使 用 方法 和 console.log() 一 致 ， 将 3.3.2 
小 节 的 代码 换 成 console.info()、console.warn()、console.error() 方 法 ， 将 得 到 同样 的 结果 : 





3.3.4 ”console.dir() 方 法 
console.dir() 方 法 用 于 将 一 个 对 象 的 信息 输出 到 控制 台 。 如 下 代码 将 定义 一 个 简单 的 对 象 。 
【示例 3-5】 





console.log('get'); 


ys 
set: function() { 


console.log('set'); 


} 
console.dir (obj); 


在 RPEL 交互 运行 环境 中 运行 这 段 代码 ， 可 以 看 到 控制 台 输出 了 这 个 对 象 的 信息 ， 如 图 
3.8 所 示 。 


[Function: get], set: [Function: set] } 





图 3.8 console.dir(0) 方 法 输出 对 象 信息 


3.3.5 ”console.time() 和 console.timeEnd() 方 法 


console.time() 和 console.timeEnd() 方 法 主要 用 于 统计 一 段 代码 运行 的 时 间 。console.time() 方 
法 置 于 代码 起 始 处 ，console.timeEnd() 方 法 置 于 代码 结尾 处 。 只 需要 向 这 两 个 方法 传递 同一 个 
参数 , 就 可 以 看 到 在 控制 台中 输入 了 以 毫秒 计 的 代码 运行 时 间 。 如 下 代码 统计 了 两 个 循环 执行 
后 的 时 间 以 及 各 个 循环 分 别 使 用 的 时 间 。 

【示例 3-6】 


console.time('total time'); 








console.time('timel'); 
for(var i =0; i< 10000; i++) { 


} 
console.timeEnd('timel'); 


console.time('time2'); 
for(var i =0; i< 100000; i++) { 


} 
console.timeEnd('time2'); 


console.timeEnd('total time'); 
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将 这 段 代 码 保存 为 名 为 time.js 的 文件 。 利 用 node time 命令 运行 这 个 文件 ， 可 以 在 控制 台 
看 到 各 个 循环 的 使 用 时 间 统 计 ， 如 图 3.9 所 示 。 











图 3.9 各 个 循环 使 用 的 时 间 统 计 











3.3.6 ”console.trace() 方 法 


console.trace() 用 于 输出 当前 位 置 的 栈 信 息 ， 可 以 向 console.trace() 方 法 传递 任意 字符 串 作 
为 标志 ， 类 似 于 console.time() 中 的 参数 。 在 RPEL 交互 运行 环境 中 执行 以 下 代码 : 





console.trace(‘trace’); 


可 以 看 到 此 处 的 栈 信息 已 经 在 控制 台中 输出 ， 如 图 3.10 所 示 。 








图 3.10 ”console.trace0 输 出 栈 信息 


汽 
温 故 知 新 
学 完 本 章 ， 读 者 需要 回答 : 
1. 简要 介绍 JavaScript 的 语法 。 
2. JavaScript 中 将 其 他 数据 类 型 转化 为 布尔 值 时 需要 注意 哪些 地 方 ? 
3. 文中 提 到 JavaScript 的 编程 规范 有 哪些 ? 如 果 由 你 来 主导 一 个 JavaScript 项 目 ， 你 会 怎 
样 制 定 这 个 项 目的 规范 ? 
4. Nodejs 中 的 控制 台 如 何 统计 代码 的 运行 时 间 ? 
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第 4 章 
<Node.js 中 的 己 管 理 > 


Nodejjs 的 模块 加 载 机 制 可 以 让 开发 时 更 好 地 划分 程序 的 功能 , 从 而 更 好 地 做 到 代码 解 耦 ， 
同时 利于 进行 模块 化 开发 ， 保 证 写 出 的 Nodejs 代码 优雅 、 易 读 。 同 时 ，Node.js 的 包 管理 工具 
NPM 可 以 很 方便 地 下 载 使 用 第 三 方 模块 ， 简 化 开发 工作 ， 提 高 项 目 开 发 效率 。 本 章 将 介绍 
Node.js 的 包 管理 工具 NPM 的 使 用 和 Node.js 核心 模块 的 使 用 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 

@ 从 NPM 下 载 使 用 第 三 方 模块 ， 并 了 解 package.json 文件 的 使 用 。 

@ 了 解 Nodejs 的 模块 机 制 。 

@ 通过 实例 了 解 Node.js 核心 模块 的 使 用 ， 通 过 实例 的 讲解 快速 掌握 各 个 核心 模块 的 常 

用 方法 。 


NPM 介绍 


NPM 是 Node.js 的 包 管 理工 具 。 它 的 重要 性 就 像 gem 之 于 Ruby 一 样 。Node.js 与 NPM 的 
关系 是 密 不 可 分 的 。 
4.1.1 NPM 常用 命令 


NPM 默认 是 与 Node.js 一 起 安装 的 ， 可 以 在 命令 行 中 输入 “npm”， 验 证 NPM 是 否 安装 ， 
如 图 4.1 所 示 。 


huruji@DESKTOP-KGS221K MIN 


Usage: npm <command> 





图 4.1 NPM 验证 安装 结果 


1. npm -v、npm version 


通过 输入 npm -v 命令 或 者 npm version 命令 可 以 查看 NPM 的 安装 版 本 ， 如 图 4.2 所 示 。 


huruji@DESKTOP-KGS221K MIN 
$ npm -v 
3.10.8 


huruji@DESKTOP-KGS221K M 
$ npm version 
{ npm: “3.10.8., 


ares: Wp ， 
http_， parser 7 





图 4.2 NPM 查看 版 本 结果 


2. npm init 

通过 npm init 命令 可 以 生成 一 个 packagejson 文件 。 这 个 文件 是 整个 项 目的 描述 文件 。 通 
过 这 个 文件 可 以 清楚 地 知道 项 目的 包 依赖 关系 、 版 本 、 作 和 每 个 NPM 包 都 有 自己 的 
package.json 文件 ， 使 用 这 个 命令 将 需要 填写 项 目 名 、 版 本 号 、 作 者 等 信息 ， 有 具体 如 图 4.3 所 
示 。 





百 ， 





图 4.3 npm init 生成 packagejson 文件 


填写 完毕 后 ， 可 以 看 到 在 使 用 命令 的 文件 夹 中 多 了 一 个 package.json 文件 。 当 然 ， 如 果 读 
者 不 想 填写 这 些 内 容 ， 也 可 以 在 这 条 命令 后 添加 参数 -y 或 者 --yes， 这 样 系统 将 会 使 用 默认 值 
生成 packagejson 文件 ， 例 如 : 
npm init -Y 
//or 
npm int --yes 

3. npm install 

通过 npm install 命令 安装 包 , 如 安装 underscore 这 个 包 (underscore 是 一 个 强大 的 JavaScript 
工具 库 ， 使 用 这 个 库 可 以 大 大 提高 开发 效率 ) ， 如 图 4.4 所 示 。 


huruji\Desktop\Node-npm 








图 4.4 安装 underscore 结果 
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命令 运行 完毕 后 , 可 以 发 现在 运行 命令 的 文件 夹 中 多 了 一 个 名 为 node-modules 的 文件 夹 ( 用 
来 存放 安装 包 的 文件 夹 ) 。 打 开 这 个 文件 夹 就 可 以 找到 名 为 underscore 的 文件 夹 〈 用 来 存放 
underscore 包 ) ， 如 图 4.5 所 示 。 














口 ucENsE 文件 
器 packagejson 
呈 README.md 


国 underscorejs 





国 underscore-minjs 


国 underscore-min.map Linker Address 
图 4.5 underscore 文件 夹 下 的 文件 
在 安装 包 的 时 候 同 样 可 以 在 命令 后 添加 --save 或 者 -S 参数 ， 这 样 安装 包 的 信息 将 会 记录 在 
package.json 文件 的 dependencies 字段 中 ， 如 图 4.6 所 示 。 这 样 将 可 以 很 方便 地 管理 包 的 依赖 
关系 。 


"dependencies";: 1 


"underscore": "^ 


下 
J 





图 4.6 使 用 --save 参数 安装 
当然 如 果 这 个 包 只 是 开发 阶段 需要 的 ， 可 以 继续 添加 -dev 参数 。 这 样 安装 包 的 信息 将 会 
记录 在 package.json 文件 的 devDependencies 字段 中 ， 如 图 4.7 所 示 。 





图 4.7 使 用 --ave-dev 参数 安装 


建议 将 所 有 项 目 安装 的 包 都 记录 在 package.json 文件 中 。 当 我 们 的 package.json 文件 中 有 
了 依赖 包 的 记录 时 ， 只 需要 运行 npm install 命令 ， 系 统 就 会 自动 安装 所 有 项 目 需要 的 依赖 包 。 
当 不 需要 使 用 某 个 包 时 ， 可 以 运行 npm uninstall 命令 来 卸载 这 个 包 。 


4.1.2 package.json 文件 
上 文 提 到 package.json 文件 是 提供 包 描 述 的 文件 。 在 Node.js 中 ， 一 个 包 是 一 个 文件 夹 ， 
文件 夹 中 的 package.json 文件 以 json 格式 存储 该 包 的 相关 描述 。 一 个 典型 的 package.json 文件 
内 容 (这 是 underscore 的 package.json 文件 ， 有 删 减 )》 如 下 : 
{ 
anthorms { 


"name" : "Jeremy Ashkenas", 
"email": "jeremy@documentcloud.org" 


}, 
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以 下 对 主要 的 字段 进行 说 明 : 


Name: 包 的 名 字 。 

Respository: 包 存 放 的 仓库 地 址 。 

Keywords: 包 的 关键 字 ， 有 利于 别人 通过 搜索 找到 你 的 包 。 
License: 遵循 的 协议 。 
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Maintainers: 包 的 维护 者 。 
Author: 包 的 作者 。 
Version: 版 本 号 ， 遵 循 版 本 命名 规范 。 
Dependencies: 包 依赖 的 其 他 包 。 
devDependencies: 包 开 发 阶段 所 依赖 的 包 。 
@ homepage: 包 的 官方 主页 。 
当然 以 上 仅仅 是 列举 了 最 常见 的 字段 ， 所 有 的 字段 解释 说 明 读 者 可 以 在 网 站 
https://docs.npmjs.com/files/package.json 找到 。 


4 .2 模块 加 载 原理 与 加 载 方式 


Nodejs 中 的 模块 可 以 分 为 原生 模块 和 文件 模块 。 在 Node.js 中 可 以 通过 require 方法 导入 
模块 、exports 方法 导出 模块 。 


4.2.1 require 导入 模块 


对 于 原生 模块 (如 http) ， 只 需要 使 用 require (Chttp') 导入 这 个 模块 并 将 其 赋值 给 一 个 变 
量 即 可 使 用 这 个 模块 导出 的 属性 、 方 法 等 。 





对 于 文件 模块 ， 可 以 使 用 “./” 前 绥 来 指 代 当前 路 径 ， 从 而 使 用 相对 路 径 来 加 载 模块 。 加 
载 模块 时 ， 可 以 省 略 ,js 拓展 名 。 例 如 ， 在 同 级 的 文件 夹 node 中 有 一 个 名 为 myModulejs 的 文 
件 模块 ， 可 以 这 样 导 入 : 


在 4.1 节 中 利用 NPM 下载 了 underscore 模块 ， 那么 在 node_modules 文件 夹 的 同 级 目录 可 
以 这 样 加 载 : 


这 是 因为 Nodejjs 内 部 会 自动 查找 加 载 node_modeles 文件 夹 下 的 模块 。 

这 里 有 必要 了 解 一 下 Nodejs 尝试 路 径 的 顺序 。 例 如 ， 某 个 模块 的 绝对 路 径 是 
home/hello/hellojs， 在 该 模块 中 导入 其 他 模块 ， 写 法 为 require("me/first")， 则 Node.js 会 依次 尝 
试 使 用 路 径 : 


/home/node modules/me/first 


node modules/me/first 


4.2.2 ”exports 导出 模块 
-个 模块 中 的 变量 和 方法 只 能 用 于 这 个 模块 , 如 果 想 要 与 其 他 模块 共享 一 些 方法 、 属 性 等 ， 
就 可 以 用 exports 导出 一 个 对 象 。 这 个 对 象 可 以 包含 想 要 与 其 他 模块 共享 的 方法 和 属性 等 。 
假设 一 个 模块 中 有 两 个 想 要 与 其 他 模块 共享 的 方法 , 一 个 用 于 数组 去 重 , 一 个 用 于 计算 数 
组 之 和 ， 可 以 像 下 面 这 样 导出 : 








const util = { 
noRepeat: function (arr) { 
return arr.filter(function(ele, index) { 
return arr.indexOf (ele)==index; 
}); 
}, 
add: function(arr) { 
return arr.reduce (function(elel, ele2) { 
return elel + ele2; 
}) 7 


]} 


module.exports = util; 
假设 将 这 个 模块 保存 为 exportsjs， 同 级 目录 下 通过 require 使 用 该 模块 ， 代 码 如 下 : 
const arrFn = require('./exports'); 


const arr = [1,2,3,3,2]; 


let noRepeatArr = arrFn.noRepeat (arr); 
let num = arrFn.add (arr); 


console.1log (noRepeatArr); 
console.1log (num); 

运行 这 段 代码 后 ， 可 以 在 控制 台 看 到 输出 数组 [1,2,3] 和 数字 11, 说 明 模 块 导入 成 功 ,， 如 图 
4.8 所 示 。 


> console.lognoRepeatflrr); 





图 4.8 ”导入 模块 与 导出 模块 
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4.3 Node.js 核心 模块 


Nodejs 的 核心 模块 主要 有 http、 人 、url、querystring 模块 。 下 面 分 别 对 这 几 个 模块 进行 分 
析 。fs 模块 的 介绍 放 在 第 5 章 详细 介绍 。http 模块 在 第 2 章 的 例子 中 使 用 过 ， 本 节 将 详细 分 析 
其 方法 和 原理 。 


4.3.1 http 模块 一 一 创建 HTTP 服务 器 、 客 户 端 


使 用 http 模块 只 需要 在 文件 中 通过 require('http) 引 入 即 可 。http 模块 是 Nodejs 原生 模块 
中 最 为 亮 眼 的 模块 。 传 统 的 HTPP 服务 器 会 由 Apache、Nginx、IIS 之 类 的 软件 来 担任 ， 但 是 
Node.js 并 不 需要 。Node.js 的 http 模块 本 身 就 可 以 构建 服务 器 ， 而 且 性 能 非常 可 靠 。 


1. Nodejs 服务 器 端 
下 面 创建 一 个 简单 的 Nodejs 服务 器 。 
【示例 4-1】 





【代码 说 明 】 
运行 这 段 代 码 ， 在 浏览 器 中 打开 http://localhost:3000/ 或 者 http://127.0.0.1:3000/， 页 面 中 显 
示 “Hello，Nodejs! ”文字 。 
http.createServer() 方 法 返回 的 是 http 模块 封装 的 一 个 基于 事件 的 http 服务 器 。 同 样 ， 
http.request 是 其 封装 的 一 个 http 客户 端 工具 ， 可 以 用 来 向 http 服务 器 发 起 请 求 。 上 面 的 req 和 
res 分 别 是 http.IncomingMessage 和 http.ServerResponse 的 实例 。 
http.Server 的 事件 主要 有 : 
@ request: 最 常用 的 事件 ， 当 客户 端 请 求 到 来 时 ， 该 事件 被 触发 ， 提 供 req 和 res 两 个 
参数 ， 表 示 请 求 和 响应 信息 。 
@ connection: 当 TCP 连接 建立 时 ,该 事件 被 触发 , 提供 一 个 socket 参数 ， 是 net.Socket 
的 实例 。 
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@ close: 当 服 务 器 关闭 时 ， 触 发 事件 ( 注意 不 是 在 用 户 断 开 连 接 时 ) 。 


http.createServer() 方 法 其 实 就 是 添加 了 一 个 request 事件 监听 , 利用 下 面 的 代码 同样 可 以 实 
现 【 示 例 4-1】 的 效果 。 


【示例 4-2】 





http.IncomingMessage 是 HTTP 请 求 的 信息 ， 提 供 了 以 下 3 个 事件 : 
@ data: 当 请 求 体 数据 到 来 时 该 事件 被 触发 。 该 事件 提供 一 个 chunk 参数 ， 表 示 接 受 的 
数据 。 
@ end: 当 请 求 体 数据 传输 完毕 时 该 事件 被 触发 ， 此 后 不 会 再 有 数据 。 
@ close: 用 户 当前 请 求 结束 时 ， 该 事件 被 触发 。 
http.IncomingMessage 提供 的 主要 属性 有 : 
@ method: HTTP 请 求 的 方法 ， 如 GET。 
@ headers: HTTP 请 求 头 。 
@ url: 请 求 路 径 。 
@ httpVersion: HTTP 协议 的 版 本 。 
将 上 面 提 到 的 知识 融合 到 【示例 4-1】 的 服务 器 代码 中 。 
【示例 4-3】 











打开 浏览 器 输入 地 址 后 ， 可 以 在 浏览 器 页 面 中 看 到 如 图 4.9 所 示 的 信息 。 


ul:/ 


headers: {host”:“localhost:3000”, “conmnection”: “keep-alive” ,cache-control”: “max- 
age=0”, ep et :1”, ‘user-agent”: Mozilla/5.0 (Windows NT 10.0; 


Yowed)” AppleWebkit/537. 36 (KHINL, like Gecko) Chrome/55. 0. 2883. 87 
Safari/537. 36”, “accept”:”text/html, application/xhtml +xml, application/xml; q=0. 9, image/webp, 
encoding”: ”gzip, deflate, sdch, br”,” accept-language”:” zh-CN, zh;q=0.8”} 


httpVersion:1.1 





图 4.9 浏览 器 效果 
http.ServerResponse 是 返回 给 客户 端的 信息 ， 其 常用 的 方法 为 : 


®@ res.writeHead(statusCode,[heasers]): 向 请 求 的 客户 端 发 送 响应 头 。 
@ res.write(data,[encoding]): 向 请 求 发 送 内 容 。 
@ res.end([data],[encoding]): 结束 请 求 。 


这 些 方法 在 上 面 的 代码 中 已 经 演示 过 了 ， 这 里 就 不 再 演示 了 。 
2. 客户 端 向 http 服务 器 发 起 请 求 
以 上 方法 都 是 http 模块 在 服务 器 端的 利用 ， 接 下 来 看 客户 端的 利用 。 向 http 服务 器 发 起 


请 求 的 方法 有 : 
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@ http.request(option[,callback]): option 为 json 对 象 , 主要 字段 有 host、 port( 默认 为 80 )、 
method (默认 为 GET ) 、path ( 请 求 的 相对 于 根 的 路 径 ， 默 认 是 “/” ) 、headers 等 。 
该 方法 返回 一 个 httpClientRequest 实例 。 

@ http.get(option[,callback]): http.request() 使 用 HTTP 请 求 方式 GET 的 简便 方法 。 


同时 运行 【示例 4-1】 和 【示例 4-4】 的 代码 , 我 们 可 以 发 现 命令 行 中 输出 “Hello, Nodejs!” 
字样 ， 表 明 一 个 简单 的 GET 请 求 发 送 成 功 了 。 


【示例 4-4】 





利用 http.get0 方 法 也 可 以 实现 同样 的 效果 。 
【示例 4-5】 





与 服务 端 一 样 ，http.request0 和 http.get() 方 法 返回 的 是 一 个 http.ClientRequest() 实 例 。 
http.ClientRequestO 类 主要 的 事件 和 方法 有 : 


@ Iesponse: 当 接 受到 响应 时 触发 。 
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@ request.write(chunk[,encoding][,callback]): 发 送 请 求 数据 。 
@ res.end([data][,encoding][,callback]): 发 送 请 求 完毕 ， 应 该 始终 指定 这 个 方法 。 


同样 可 以 改写 上 述 代 码 为 【示例 4-6】。 


【示例 4-6】 





4.3.2 url 模块 一 一 url 地 址 处 理 


使 用 url 模块 ， 只 需要 在 文件 中 通过 require(ur1) 引 入 即 可 。url 模块 是 一 个 分 析 、 解 析 url 
的 模块 ， 主 要 提供 以 下 三 种 方法 : 

@ url.parse(urlStr[,parseQueryString][,slashesDenoteHost]): 解析 一 个 url 地 址 ， 返 回 一 个 
url 对 象 。 

@ urlformate(urlObj): 接受 一 个 url 对 象 为 参数 ， 返 回 一 个 完整 的 url 地 址 。 

@ urlresolve(from, to): 接受 一 个 base url 对 象 和 一 个 hrefurl 对 象 ， 像 浏览 器 那样 解析 ， 
返回 一 个 完整 地 址 。 

【示例 4-7】 





在 控制 台中 输出 如 图 4.10 所 示 的 信息 ， 说 明 解 析 成 功 。 





图 4.10 解析 url 


利用 url.format() 方 法 返回 上 述 完 整地 址 的 代码 如 下 : 
【示例 4-8】 


const url = require('url'); 


let urlobj = { 
"host': "www.google.com'y 
Vports .005 
protocols https's 
'search':'?q=node.js', 
"query': 'q=node.js', 
path ys 

}; 

let urlAdress = url.format (urlO0bj); 


console.log (urlAdress); 


运行 代码 后 ， 可 以 在 控制 台 看 到 完整 的 url 地 址 。 
resolve 的 使 用 方法 如 下 : 


【示例 4-9】 
const Url = require('url'); 


let urlAdress = url.resolve('https://www.google.com', '/image'); 


console.log (urlAdress); 


运行 代码 可 以 在 控制 台 看 到 完整 的 url 地 址 https://www.google.com/image。 


4.3.3 querystring 模块 一 一 查询 字符 串 处 理 

使 用 querystring 模块 ， 只 需要 在 文件 中 通过 require(querystring) 引 入 即 可 。querystring 模 
块 是 一 个 处 理 查询 字符 串 的 模块 。 这 个 模块 的 主要 方法 有 : 

@ querystring.parse(): 将 查询 字符 囊 反 序列 化 为 一 个 对 象 ， 类 似 JSON.parse()。 


2 入 


®@ querystring.stringify(): 将 一 个 对 象 序列 化 为 一 个 字符 串 ， 类 似 JSON.stringify()。 
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下 面 演示 它们 的 使 用 方法 。 
将 查询 字符 串 反 序列 化 为 一 个 对 象 。 


【示例 4-10】 





将 对 象 序列 化 为 一 个 查询 字符 串 。 
【示例 4-11】 





4.4 Node.js 常用 模块 


除了 上 述 提 到 的 核心 模块 外 ，Node.js 还 有 一 些 常 用 的 模块 。 


4.4.1 util 模块 一 一 实用 工具 
util 模块 是 一 个 工具 模块 ， 提 供 的 主要 方法 有 : 


@ util.inspect0: 返回 一 个 对 象 反 序 列 化 形成 的 字符 串 。 

@ util.format(): 返回 一 个 使 用 占 位 符 格式 化 的 字符 囊 ， 类 似 于 C 语 言 的 printf。 可 以 使 
用 的 占 位 符 有 %s、%d、%ij。 

@ util.log(): 在 控制 台 输出 ， 类 似 于 console.log()， 但 这 个 方法 带 有 时 间 鹤 。 

下 面 将 用 代码 说 明 这 些 方法 的 使 用 。 


【示例 4-12】 
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上 面 这 段 代 码 已 经 将 对 象 反 序列 化 为 一 个 字符 串 。 之 所 以 说 这 个 方法 在 调试 的 时 候 非 常 有 


用 ， 是 因为 我 们 还 可 以 让 控制 台 输 出 字符 串 带 有 颜色 和 风格 。 这 非常 利于 区 分 各 种 数据 类 型 。 
Node.js 默认 的 风格 可 参考 表 4-1。 


表 4-1 Node.js 默认 的 风格 


正则 表达 式 


只 需要 在 这 个 方法 添加 一 个 json 对 象 参数 、 将 color 字段 设置 为 true 即 可 。 
【示例 4-13】 


如 果 util.format 方法 中 的 参数 少 于 占 位 符 ， 那么 多 余 的 占 位 符 不 会 被 蔡 换 ， 如果 参 数 多 于 
占 位 符 ， 那 么 剩余 的 参数 将 通过 util.spect0 方 法 转换 为 字符 串 ; 如 果 没 有 占 位 符 ， 就 将 以 空格 
分 隔 各 个 参数 并 拼接 成 字符 串 。 


【示例 4-14】 
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除了 这 些 方法 外 ，util 模块 还 提供 了 一 些 判断 数据 类 型 的 函数 ， 如 utilisArray()、 
utiLisRegExp()、util.isDate() 等 。 


4.4.2 “path 模块 一 一 路 径 处 理 
path 模块 提供 了 一 系列 处 理 文件 路 径 的 工具 ， 主 要 的 方法 有 : 


@ path.join(): 将 所 有 的 参数 连接 起 来 ， 返 回 一 个 路 径 。 

@@ path.extname(): 返回 路 径 参 数 的 拓展 名 ， 无 拓展 名 时 返回 空 字符 串 。 
@ path.parse(): 将 路 径 解 析 为 一 个 路 径 对 象 。 

@ path.format(): 接受 一 个 路 径 对 象 为 参数 ， 返 回 一 个 完整 的 路 径 地 址 。 
下 面 用 代码 说 明 这 些 方 法 的 使 用 。 


【示例 4-15】 


假设 上 面 这 段 代码 文件 存放 的 文件 夹 为 C 盘 目 录 下 的 frontEnd 文件 夹 下 , 即 _dimame 表 
示 CxfrontEnd， 则 返回 ， 


利用 path.extname() 方 法 解析 上 面 代码 返 回路 径 中 的 拓展 名 js， 代 码 如 下 : 
【示例 4-16】 


在 Nodejs 中 , 一 个 文件 对 象 有 root、dir、base、ext、name 五 个 字段 ， 分 别 对 应 根 目录 (一 
般 是 磁盘 名) 、 完 整 目录 、 路 径 最 后 一 个 部 分 〈 可 能 是 文件 名 或 文件 夹 名 ， 是 文件 名 时 带 拓展 
名 )、 拓 展 名 、 文件 名 (不 带 拓展 名 ) ， 可 以 利用 以 下 代码 将 上 面 的 地 址 解析 成 一 个 路 径 对 象 。 


【示例 4-17】 


const str = 'C:/frontEnd/node/node.js'; 


let obj = path.parse (str); 


console.1og (obj); 


我 们 将 在 控制 台 看 到 如 图 4.11 所 示 的 输出 。 


图 4.11 解析 路 径 


字符 串 。 


4.4.3 dns 模块 
dns 模块 的 功能 是 域名 处 理 和 域名 解析 ， 常 用 方法 有 : 


@ dns.resolve(): 将 一 个 域名 解析 为 一 个 指定 类 型 的 数组 。 
@ dns.lookup(): 返回 第 一 个 被 发 现 的 IPv4 或 者 IPv6 的 地 址 。 
@ dns.reverse(): 通过 JIP 解析 域名 。 


下 面 用 代码 说 明 这 些 方 法 的 使 用 。 
可 以 通过 dns.resolve() 方 法 解析 一 下 百度 的 IPv4 地 址 。 


【示例 4-18】 


const dns = require('dns'); 
let domain = "baidu.com' 7 


dns .resolve (domain，function(err，address) { 


ifl(err) { 
console.log (err); 
return; 

} 


console.log(address); 
} 


运行 代码 后 ， 可 以 在 控制 台中 看 到 如 图 4.12 所 示 的 数组 输出 。 





图 4.12 解析 DNS 
利用 dns.lookup() 方 法 会 返回 上 面 这 个 数组 中 的 一 个 元 素 。 
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【示例 4-19】 





笔者 控制 台 输 出 的 便 是 上 面 数 组 中 的 第 二 个 元 素 ， 即 111.13.101.208 这 个 地 址 。 读 者 可 以 
自行 查看 一 下 自己 网 络 返 回 的 地 址 。 

我 们 将 一 个 IP 地 址 114.114.114.114 传递 给 dnsreverse() 方 法 ， 就 会 得 到 一 个 域名 数组 ， 
不 过 这 个 数组 中 只 有 public1.114dns.com 这 个 域名 。 


【示例 4-20】 


4 .实战 一 他 取 网 页 图 片 
本 节 将 利用 本 章 所 介绍 的 知识 实现 一 个 完整 的 实例 : 利用 Nodejs 爬 取 一 个 网 页 ， 通 过 第 
三 方 模块 cheerio.js 分 析 这 个 网 页 的 内 容 ， 最 后 将 这 个 网 页 的 图 片 文件 保存 在 本 地 。 
4.5.1 项 目 目录 与 思路 
整个 实例 的 项 目 目录 如 图 4.13 所 示 。 
| img 
J node modules 
加 analyzejs 





加 configjs 
加 indexjs 
时 packagejson 














4.13 ”实例 项 目 目录 
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img 文件 夹 用 来 存储 图 片 文件 。 

node_modules 文件 夹 是 模块 默认 的 保存 位 置 。 

indexjs 文件 是 整个 项 目的 入 口 文件 。 

configjs 文件 是 配置 文件 ， 用 来 放置 网 页 地 址 和 图 片 文件 夹 的 路 径 。 这 样 做 的 目的 是 
使 整个 项 目的 可 拓展 性 增强 。 

@ analyze.js 文件 用 来 存储 分 析 DOM 的 方法 。 

@ packagejson 文件 是 包 的 描述 文件 。 


整体 的 思路 就 是 通过 第 三 方 模块 request 请 求 网 页 地 址 ， 从 而 得 到 整个 网 页 的 DOM 结构 ， 
根据 DOM 结构 利用 cheerio 模块 分 析出 图 片 文件 的 地 址 ， 再 次 请 求 这 个 地 址 ， 最 后 将 得 到 的 
图 片 数据 储存 在 本 地 。 


4.5.2 下载 第 三 方 模块 


如 前 面 章节 的 介绍 ， 我 们 可 以 利用 npm install 命令 下 载 需要 的 模块 。 下 面 的 代码 就 将 我 
们 需要 的 request 和 cheerio 模块 下 载 到 了 本 地 : 


打开 node_modules 文件 夹 便 可 找到 相应 模块 的 文件 。 


4.5.3 ”配置 网 页 地 址 及 图 片 存放 的 文件 夹 


这 里 将 配置 内 容 写 入 config.js 文件 中 ， 再 在 文件 中 通过 exports 导出 这 些 配 置 内 容 ， 从 而 
使 其 他 文件 可 以 使 用 ， 代 码 如 下 : 





这 里 读者 可 自行 将 请 求 的 网 址 填写 在 url 变量 中 。 


4.5.4 解析 DOM 得 到 图 片 地 址 


这 里 假设 我 们 已 经 得 到 了 DOM 结构 ， 将 分 析 DOM 部 分 的 代码 写 入 analyze.js 文件 中 ， 
通过 cheerio 得 到 每 一 张 图 片 的 地 址 ， 最 后 利用 一 个 回调 函数 callback 处 理 这 个 地 址 (当然 在 
这 里 回调 函数 callback 是 发 送 请 求 ) ， 代 码 如 下 : 


O) 
Co 
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cheerio 模块 可 以 使 开发 者 像 jQuery 一 样 操作 DOM。 这 里 得 到 了 请 求 网 页 中 每 一 张 图 片 
文件 的 地 址 。 读 者 可 以 通过 更 多 的 DOM 分 析 过 滤 部 分 不 需要 的 图 片 , 留 下 自己 最 想 要 的 图 片 。 


4.5.5 “请求 图 片 地 址 


这 里 将 请 求 的 操作 放 在 主 模块 index.js 文件 中 ， 将 config.js 和 analyze.js 文件 引入 这 个 模 
块 ， 利 用 request 模块 请 求 图片 地 址 ， 得 到 DOM 结构 。 将 DOM 结构 给 analyze 的 findImg 方 
法 处 理 ， 代 码 如 下 : 





4.5.6 ”图片 文件 的 保存 


通过 分 析 DOM 结构 得 到 图 片 地 址 后 ， 利 用 request 再 次 发 送 请 求 ， 将 请 求 得 到 的 数据 写 
入 本 地 即 可 。 这 里 也 将 其 封装 成 一 个 函数 ， 追 加 在 indexjs 文件 中 ， 代 码 如 下 : 
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同时 ， 我 们 也 要 将 这 个 downLoad 函数 作为 参数 传递 给 analyze 模块 的 findImg 方法 ， 最 
后 运行 这 个 项 目的 主 函数 start0)， 这 样 项 目 才 会 运行 起 来 。indexjs 文件 中 的 完整 代码 如 下 : 





4.5.7 ”启动 项 目 


利用 命令 行 运行 index.js 文件 便 可 以 启动 这 个 项 目 了 。 代 码 运行 一 段 时 间 后 ， 可 以 在 img 
文件 夹 中 找到 那些 保存 的 图 片 。 这 里 只 是 演示 了 一 个 最 基本 的 仆 取 图 片 并 保存 的 代码 , 如 前 文 
所 述 ， 如 果 读 者 需要 精确 保存 需要 的 图 片 ， 就 要 对 DOM 结构 进行 更 加 详细 的 分 析 。 


处.O 温 故 知 新 


学 完 本 章 ， 读 者 需要 回答 : 


1. 如 何 通 过 NPM 下 载 第 三 方 模块 ? 

2. 如 何 生 成 一 个 package.json 文件 ? 

3. package.json 文件 有 哪些 主要 的 字段 ， 分 别 代表 什么 意思 ? 
4. Nodejs 如 何 导出 和 引入 模块 ? 

5. Node.js 的 核心 模块 主要 有 哪些 ， 分 别 有 哪 些 常 用 的 方法 ? 
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文件 的 操作 在 Nodejs 的 编程 中 非常 重要 。Nodejs 可 以 跨 平台 运行 ,所 以 在 处 理 文件 的 操 
作 时 需要 考虑 不 同 操作 系统 的 区 别 。Node.js 同时 提供 大 量 核心 的 API 和 外 部 模块 供 开发 人 员 
轻松 地 进行 文件 的 读 写 和 其 他 操作 ， 并 以 高 效率 著称 。 本 章 将 深入 讨论 如 何在 Node.js 中 使 用 
这 些 模块 来 完成 文件 操作 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 


@ 文件 路 径 : 学 会 如 何 处 理 文件 的 路 径 和 从 文件 路 径 中 获取 信息 。 

® ”打开 和 关闭 文件 ， 学 会 如 何 打 开 一 个 已 存在 的 文件 和 在 文件 操作 结束 后 正常 关闭 文件 。 

@ ” 读 写 文件 ， 学 会 如 何 使 用 Nodejs 包 读 取 和 写 入 纯 文 本 文件 、XML 文件 、CSV 文件 
和 JSON 文件 。 

e ”文件 操作 的 组 合 应 用 : 通过 本 章 最 后 的 实例 ,演示 如 何 组 织 从 文本 文件 中 读 取 数据 并 
修改 数据 格式 重新 生成 对 应 的 CSV 文件 。 


本 局 本 章 内 容 不 包含 对 数据 库 的 操作 。 


与 .1 Nodejs 文 件 系统 介绍 


Node.js 为 文件 操作 提供 了 大 量 的 API。 这 些 API 基本 上 和 UNIX (POSIX) 中 的 API 相 
对 应 。Nodejs 在 操作 文件 时 使 用 的 是 全 (File System) 模块 。 文 件 系 统 模块 均 有 两 种 不 同 的 
方法 ， 分 别 是 异步 和 同步 版 本 。 


5.1.1 同步 和 异步 


为 了 使 用 Nodejjs 进行 文件 操作 ， 首 先 要 使 用 require('fs") 来 加 载 文 件 系 统 模块 。 异 步 方 法 
的 最 后 一 个 参数 总 是 一 个 完整 的 回调 函数 〈callback 函数 ) 。 传 递 给 回调 函数 的 参数 一 般 取决 
于 这 个 方法 本 身 ， 但 是 第 一 个 参数 永远 是 异常 (err) 。 如 果 方 法 执行 成 功 ， 第 一 个 参数 将 会 
是 null 或 者 undefined。 当 使 用 同步 方法 来 执行 时 ， 任 何 异 常 都 会 立刻 引发 。 我 们 可 以 使 用 try 
或 者 catch 来 处 理 异常 并 将 错误 信息 显示 出 来 。 

下 面 给 出 一 个 异步 方法 的 例子 ， 其 中 tmp 文件 夹 下 有 一 个 hello 文件 。 
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【示例 5-1】 





【代码 说 明 】 
这 段 代码 将 删除 在 tmp 目录 下 的 hello 文件 ， 如 果 删 除 成 功 就 在 console 中 打印 删除 成 功 
的 信息 。 也 可 以 使 用 同步 的 方法 实现 同样 的 功能 。 下 面 的 代码 将 使 用 同步 的 方法 执行 相同 的 操作 : 





异步 操作 的 方法 不 能 保证 执行 一 定 成 功 ,所 以 文件 操作 的 顺序 在 代码 执行 过 程 中 是 非常 重 
要 的 ， 例 如 下 面 的 代码 将 会 引发 一 个 错误 。 


【示例 5-2】 





fs.stat 将 在 fs.rename 之 前 执行 ， 正 确 的 方法 是 使 用 回调 函数 来 执行 。 下 面 的 代码 是 正确 
使 用 回调 函数 来 处 理 程序 执行 过 程 中 的 异常 : 


在 一 个 大 型 的 系统 中 ， 建 议 使 用 异步 方法 ， 同 步 方法 将 会 导致 进程 被 锁 死 。 和 同步 方法 相 
比 ， 异 步 方法 性 能 更 高 ， 速 度 更 快 、 而 且 阻 塞 更 少 。 本 书 以 介绍 异步 方法 为 主 、 同 步 方 法 
为 辅 。 
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5.1.2 fs 模块 中 的 类 和 文件 的 基本 信息 


Node.js 在 文件 模块 中 只 有 4 个 类 ， 分 别 为 fs.FSWatcher、fs.ReadStream、fs.Stats 和 
fs.WriteStream。 其 中 ，fs.ReadStream 和 fs.WriteStream 分 别 是 读 取 流 和 写 入 流 , 我 们 将 在 后 面 
的 内 容 中 进行 介绍 ，fs.FSWatcher 和 fs.Stats 可 以 获取 文件 的 相关 信息 。 
stats 类 中 的 方法 有 : 
@ stats.isFile(): 如 果 是 标准 文件 就 返回 true， 如 果 是 目录 、 套 接 字 、 符 号 连接 或 设备 等 
就 返回 false。 

@@ stats. isDirectory(): 如 果 是 目录 就 返回 true。 

@@ stats. isBlockDevice(): 如 果 是 块 设备 就 返回 true。 大 多 数 情况 下 类 UNIX 系统 的 块 设 
备 都 位 于 /dev 目录 下 。 

@ stats. isCharacterDevice(): 如 果 是 字符 设备 就 返回 true。 

@ stats. isSymbolicLink(): 如 果 是 符号 连接 就 返回 true。fs.lstat() 方 法 返回 的 stats 对 象 才 

@ stats.isFIFO(): 如 果 是 FIFO 就 返回 true, FIFO 是 UNIX 中 一 种 特殊 类 型 的 命令 管道 。 

@ stats. isSocket(): 如 果 是 UNIX 套 接 字 就 返回 true。 


使 用 fs.stat()、fs.lstat0 和 fs.fstat0) 方 法 都 将 返回 文件 的 一 些 特征 信息 ， 如 文件 的 大 小 、 创 
建 时 间或 者 权限 。 一 个 典型 的 查询 文件 元 信息 的 代码 如 下 : 
【示例 5-3】 


Var fs = require('fs'); 


fs.stat('/Users/liuht/code/itbilu/demo/path.js', function (err, stats) { 
console.log (stats); 
}) 


运行 上 面 的 代码 ， 将 会 输出 如 图 5.1 所 示 的 文件 信息 。 


dev: 2114, 
ino; 48964969， 





图 5.1 文件 信息 查询 结果 


5.1.3 文件 路 径 
在 Nodejs 中 访问 文件 既 可 以 使 用 相对 路 径 又 可 以 使 用 绝对 路 径 。 我 们 可 以 使 用 path 模块 
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功能 来 修改 链接 、 解 析 路 径 ， 还 可 以 将 路 径 进行 转换 和 规范 化 。 需 要 注意 的 是 ， 在 不 同 操作 系 
统 的 路 径 分 隔 也 不 一 样 ， 如 有 的 需要 带 “/”， 有 的 不 需要 。 因 此 ， 处 理 文件 路 径 会 比较 困难 ， 
使 用 path 模块 可 以 很 好 地 解决 这 些 问 题 。 

使 用 path 模块 时 ， 首 先 要 用 require('path') 进 行 引用 。path 模块 主要 有 以 下 几 个 主要 功能 : 


@ 规范 化 路 径 

@ ”连接 路 径 

@ ”路径 解析 

@。 查找 路 径 之 间 的 关系 
@ ”提取 路 径 中 的 部 分 内 容 





下 面 的 代码 使 用 normalize() 方 法 来 规范 化 路 径 字 符 串 , 在 存储 和 使 用 路 径 之 前 将 其 规范 化 
可 以 避免 之 后 的 错误 引用 。 





join( 方 法 可 以 连接 任意 多 个 路 径 字符 串 。 要 连接 的 多 个 路 径 可 作为 参数 传 入 。 下 面 给 出 
一 个 路 径 连 接 的 示例 。 


【示例 5-4】 





【代码 说 明 】 
path.relative() 方 法 可 以 找 出 一 个 绝对 路 径 到 另 一 个 绝对 路 径 的 相对 关系 。 例 如 ， 下 面 的 代 
码 判定 两 个 路 径 的 相对 关系 ， 结 果 将 输出 为 .…./../zszsgc/lib'。 


在 使 用 相对 路 径 的 时 候 ， 路 径 的 相对 性 应 该 与 process.cwd() 一 致 。 
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与 .2 基本 文件 操作 


Node.js 使 用 流 (stream) 的 方式 来 处 理 文件 。 这 种 处 理 方式 和 处 理 网 络 数据 几乎 是 一 样 的 ， 
操作 起 来 非常 方便 使 用 流 的 方式 操作 一 般 会 有 一 个 问题 , 即 无 法 在 文件 的 指定 位 置 进行 读 写 。 
但 是 Nodejs 进行 了 更 底层 的 操作 ， 除 了 可 以 在 文件 的 尾部 写 入 ， 也 可 以 在 文件 的 特定 位 置 写 
入 数据 。 

Node.js 中 有 丰富 的 API 支持 对 文件 的 各 种 操作 ， 包 括 获取 文件 信息 、 创 建 和 删除 文件 、 
打开 和 关闭 文件 、 读 写 数据 。 在 本 节 中 将 会 介绍 文件 的 一 些 基本 操作 ， 下 一 节 会 针对 具体 格式 
的 文件 操作 进行 讲解 。 


5.2.1 打开 文件 

在 处 理 文件 之 前 都 需要 使 用 Node.js 中 的 fs.open 方法 来 打开 文件 ,然后 才能 使 用 文件 描述 
符 调用 所 提供 的 回调 函数 。 在 异步 模式 下 打开 文件 的 语法 如 下 : 
fs.open(path, flags[, mode], callback) 

参数 使 用 说 明 如 下 : 

@ Path: 文件 的 路 径 。 

@@ ”Flags: 文件 打开 的 方式 ， 具 体 说 明 可 参见 表 5-1。 

@ Mode: 设置 文件 模式 (权限) ， 文 件 创建 默认 权限 为 可 读 写 。 

@ Callback: 回调 函数 ， 同 时 带 有 两 个 参数 。 

表 5-1 fs.open 中 flag 参数 说 明 


以 读 取 模式 打开 文件 ， 如 果 文 件 不 存在 就 抛 出 异常 
以 读 写 模式 打开 文件 ， 如 果 文 件 不 存在 就 抛 出 异常 

















以 同步 的 方式 读 取 文 件 

以 同步 的 方式 读 取 和 写 入 文件 

以 写 入 模式 打开 文件 ， 如 果 文 件 不 存在 就 创建 
WX 类 似 'w'， 但 是 如 果 文件 路 径 存 在 则 文件 写 入 失败 
Wt 以 读 写 模式 打开 文件 ， 如 果 文 件 不 存在 则 创建 
Wx+ 类 似 w+',， 但 是 如 果 文 件 路 径 存 在 则 文件 读 写 失 败 
a 以 追加 模式 打开 文件 ， 如 果 文 件 不 存在 则 创建 
ax 类 似 'a， 但 是 如 果 文 件 路 径 存在 则 文件 追加 失败 











下 面 的 代码 将 打开 一 个 文件 ， 并 在 打开 之 前 和 打开 成 功 之 后 在 console 中 显示 相对 应 的 消息 。 
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【示例 5-5】 





5.2.2 关闭 文件 


关闭 文件 将 使 用 fs.close 和 fs.closeSync 方法 。 其 中 ，fs.closeSync 为 同步 操作 的 方法 。 我 
们 在 这 里 主要 介绍 使 用 异步 的 fs.close 方法 。 它 一 共有 两 个 参数 可 以 设 定 ， 具 体 语法 如 下 : 


参数 使 用 说 明 如 下 : 
@@ ”Fd: 通过 fs.open() 方 法 返回 的 文件 描述 符 。 
@ Callback: 回调 函数 ， 没 有 参数 。 


在 实际 的 开发 过 程 中 ， 如 果 打 开 了 一 个 文件 ， 就 应 该 在 文件 操作 完成 之 后 尽快 关闭 该 文 
件 ， 为 此 可 能 需要 跟踪 那些 已 经 打开 的 文件 描述 符 ， 并 在 操作 完成 之 后 确保 文件 正确 关闭 。 下 
面 的 代码 将 建立 一 个 新 的 文本 文件 ， 并 进行 打开 文件 和 关闭 文件 的 操作 。 


【示例 5-6】 








【代码 说 明 】 
事实 上 ， 并 不 需要 经 常 使 用 fs.close 来 关闭 文件 。 除了 几 种 特例 之 外 ，Node.js 在 进程 退出 
之 后 将 自动 把 所 有 文件 关闭 。 原 因 在 于 ， 在 使 用 fs.readFile、fs.writeFile 或 fs.append 之 后 ， 它 
们 并 不 返回 任何 刀 ，Nodejs 将 在 文件 操作 之 后 进行 判断 并 自动 关闭 文件 。 例 如 ， 在 执行 下 面 
的 代码 后 并 不 需要 使 用 fs.close 来 关闭 文件 。 











在 使 用 一 些 方法 的 时 候 ， 例 如 人 .createReadStream， 在 option 中 有 autoClose 选项 ,之 后 在 


autoClose 选项 设置 为 true 的 时 候 才 会 在 文件 操作 之 后 自动 关闭 ， 详 细 内 容 请 参见 相关 方 
法 的 具体 说 明 或 Nodejs 的 官方 手册 。 





5.2.3 读 取 文件 


Node.js 目前 支持 utf-8、ucs2、ascii、binary、base64、hex 编码 的 文件 ， 并 不 支持 中 文 GBK 
或 GB2312 之 类 的 编码 ,所 以 无 法 操作 GBK 或 GB2312 格式 文件 的 中 文 内 容 。 如 果 想 读 取 GBK 
或 GB2312 格式 的 文件 , 需要 第 三 方 的 模块 支持 ， 建 议 使 用 iconv 模块 或 iconv-lite 模块 。 其 中 ， 
iconv 模块 仅 支持 Linux， 不 支持 Windows。 

在 Nodejs 中 读 取 文件 一 般 使 用 fs.read 方法 。 该 方法 从 一 个 特定 的 文件 描述 符 (fd) 中 读 
取 数 据 ， 语 法 格式 如 下 : 


参数 使 用 说 明 如 下 : 

@ fd: 通过 fs.open() 方 法 返回 的 文件 描述 符 。 

buffer: 数据 写 入 的 缓冲 区 。 

offset: 缓冲 区 写 入 的 写 入 偏 移 量 。 

length: 要 从 文件 中 读 取 的 字 节 数 。 

position: 文件 读 取 的 起 始 位 置 ， 如 果 position 的 值 为 null， 就 会 从 当前 文件 指针 的 位 

置 读 取 。 

@ callback: 回调 函数 ,有 err、bytesRead、buffer 三 个 参数 。 其 中 err 为 错误 信息 ,bytesRead 
表示 读 取 的 字 节 数 ，buffer 为 缓冲 区 对 象 。 


下 面 的 代码 是 一 个 文件 读 取 的 示例 。 首 先 ， 使 用 fs.open() 方 法 将 文件 打开 ; 然后 ， 从 第 
100 个 字 节 开始 ， 读 取 后 面 的 1024 个 字 节 的 数据 ; 读 取 完成 后 ，fs.openO 会 使 用 回调 方法 返回 
数据 ， 再 处 理 读 取 到 的 缓冲 数据 。 
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【示例 5-7】 





读 取 文件 也 可 以 使 用 多-readFile() 方 法 ， 语 法 格式 如 下 ， 
fs.readpile(filenanel, optionsl, callbac 


@ filename: 要 读 取 的 文件 。 

@ options: 一 个 包含 可 选 值 的 对 象 。 
> encoding {String|Null} 默认 为 null。 
> flag {fString} 默认 为 "。 

@ callback: 回调 函数 。 


fs.readFile 方法 是 在 fs.read 上 的 进一步 封装 ， 两 者 的 主要 区 别 是 fs.readFile 方法 只 能 读 取 
文件 的 全 部 内 容 。 






5.2.4 写 入 文件 


写 入 文件 一 般 使 用 fs.writeFile 和 fs.appendFile 方法 。 两 者 都 可 以 将 字符 串 或 者 缓存 区 中 的 
内 容 直 接 写 入 文件 ， 如 果 检 测 到 文件 不 存在 将 创建 新 的 文件 。fs.writeFile 和 fs.appendFile 的 语 
法 格式 也 非常 接近 ， 分 别 如 下 : 


(1) fs.writeFile 语法 : 


fouuriteFile(filenane, datal, optionsl, callbac) 
参数 使 用 说 明 如 下 : 


@ path: 文件 路 径 。 
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@ data: 写 入 文件 的 数据 ， 可 以 是 String (字符 串 ) 或 Buffer ( 流 ) 对 象 。 

@ options: 该 参数 是 一 个 对 象 ， 包 含 {encoding, mode, flag} ， 默 认 编码 为 utf-8， 模 式 为 
0666，flag 为 'w'。 

@ callback: 回调 函数 ， 只 包含 错误 信息 参数 (err) 。 


(2) fs.appendFile 语法 : 


Fs.appendPile(file, datal, optionsl, callbac) 
参数 说 明 如 下 ; 


@ file: 文件 名 或 者 文件 描述 符 。 

data: 可 以 是 String (字符 串 ) 或 Buffer ( 流 ) 对 象 。 

options: 该 参数 是 一 个 对 象 ， 包 含 {fencoding, mode, flag} ， 默 认 编码 为 utf-8， 模 式 为 
0666，flag 为 'w'。 

@ callback: 回调 函数 ， 只 包含 错误 信息 参数 (err) 。 


下 面 将 字符 串 〈string) 和 流 〈buffer) 作为 数据 源 写 入 一 个 文件 中 : 
【示例 5-8】 





【代码 说 明 】 
在 执行 写 入 文件 之 后 不 要 使 用 提供 的 缓存 区 , 因为 一 旦 将 其 传递 给 写 入 函数 , 缓存 区 就 处 
于 写 入 操作 的 控制 之 下 ， 直 到 函数 结束 之 后 才 可 以 重新 使 用 。 


在 写 入 文件 时 一 般 要 包含 写 入 信息 的 具体 位 置 ， 以 追加 模式 打开 文件 的 ,文件 的 游标 位 于 


文件 的 尾部 ， 因 此 写 入 的 数据 也 处 于 文件 的 尾部 。 





与 .3 其 他 文件 操作 


在 实际 的 编程 过 程 中 ， 我 们 需要 操作 多 种 不 同 格式 的 文件 。Nodejs 除了 提供 官方 的 API 
对 文件 操作 进行 支持 ， 也 可 以 通过 NPM 安装 第 三 方 的 模块 来 进行 文件 的 操作 。 本 节 主 要 介绍 
如 何 通 过 Nodejs 和 第 三 方 模块 来 操作 ， 如 CSV 文件 、XML 文件 和 JSON 文件 。 本 节 我 们 以 
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CSYV 文件 为 例 来 详细 介绍 。 

CSV 是 一 种 常见 的 数据 格式 。Node.js 中 有 很 多 模块 可 以 解析 CSV 文件 ， 这 里 建议 搭建 使 
用 node-CSV 来 进行 文件 的 解析 操作 。node-CSV 遵循 开源 的 BSD 协议 ， 项 目 在 git 网 站 的 网 
址 为 https://github.com/wdavidw/node-CSV。 它 一 共 包 含 4 个 包 ， 分 别 为 CSV-generate、 
CSV-parse、stream-transform 和 CSV-stringify。 各 个 包 的 功能 具体 如 下 : 

@ CSV-generate: 用 来 生成 标准 的 CSV 文件 。 

@ CSV-parse: 将 CSV 文件 解析 为 数组 变量 。 

@ stream-transform: 一 个 转换 框架 。 

@ CSV-stringify: 将 记录 转换 为 CSV 的 文本 。 

使 用 node-CSV 时 ， 需 要 先 通过 npm 命令 来 安装 CSV 的 包 ， 具 体 命令 如 下 : 


npm install csv 


其 中 每 个 包 都 与 stream2 和 stream3 的 标准 相 兼 容 ， 并 且 提 供 一 个 简单 的 回调 函数 。 
CSV-parse 解析 方法 可 以 使 用 多 种 选项 , 但 所 有 的 选项 都 是 可 选 的 , 而 不 是 必需 的 , 参见 表 5-2。 
表 5-2 fs.open 中 flag 参数 说 明 
LE 说 明 
delimiter (char) 设 定 分 隔 符 ， 只 能 设 定 一 个 字符 ， 默 认为 "，” 
定义 行 分 隔 符 ， 默 认 值 为 'auto'， 也 可 以 设 定 为 nix'、'mac'、'windows'、 
‘unicode' 
quote (char) 默认 为 双 引 号 ， 可 以 用 来 限定 一 个 范围 
escape (char) 设 定 转 义 字符 ， 只 能 设 定 一 个 字符 ， 默 认为 双 引 号 










rowDelimiter (charslconstant) 


































columns (arraylboolean|function) | 将 一 段 数据 设置 为 数组 ， 默 认为 null 
comment (char) 注释 ， 将 后 面 的 字符 串 都 当 作 注释 字段 ， 默 认为 " 
objname (string) 设置 标题 名 称 
skip_empty_lines (boolean) 忽略 内 容 为 空 的 行 
trim (boolean) 默认 值 为 false， 如 果 设 定 为 true 就 将 忽略 分 隔 符 附 近 的 空格 
ltrim (boolean) 默认 值 为 flse， 如 果 设置 为 true 就 将 忽略 分 隔 符 后 面 的 空格 
rtrim (boolean) 默认 值 为 false， 如 果 设置 为 true 就 将 忽略 分 隔 符 后 面 的 空格 
auto_parse (boolean) 如 果 设 置 为 tue， 将 从 默认 读 取 数据 类 型 转换 为 native 类 型 
auto_parse_date (boolean) 如 果 设 置 为 tue， 将 尝试 转换 读 取 数据 类 型 为 dates 类 型 

下 面 的 代码 将 使 用 CSV 模块 中 的 stream 来 读 取 、 解 析 和 转换 CSV 文件 。 

【示例 5-9】 


Var cvs = require('CSV'); 
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【代码 说 明 】 
首先 要 使 用 require(csv) 引用 csv 模块 ， 引 用 之 后 ， 就 可 以 直接 使 用 它 封装 的 方法 和 属性 
了 。csv0 相 当 于 实例 化 一 个 对 象 ，.from 和 .to 都 是 csv 封装 的 方法 。 


.from() 方 法 : 从 源 文件 中 读 取 数 据 ， 参 数 既 可 以 像 上 面 一 样 直 接 传 字符 串 ， 也 可 以 像 
下 面 的 高 级 应 用 传 源 文件 的 路 径 。 

.to( 方 法 : 将 从 form 方法 中 读 取出 来 的 数据 输出 ， 既 可 以 输出 到 控制 台 ， 也 可 以 输 
出 到 目标 文件 。 此 例子 是 输出 到 控制 台 。 


用 


日 .A 实战 一 用 IP 地 址 来 查询 天 气 情况 


本 节 将 利用 本 章 所 介绍 的 文件 操作 方法 实现 一 个 完整 的 实例 。 





5.4.1 项 目 思路 


从 一 个 JSON 格式 的 文件 中 读 入 IP 地 址 ， 并 利用 开放 的 GEO 服务 将 IP 地 址 转换 为 城市 
的 名 称 ， 并 将 城市 当天 的 天 气 信息 输出 到 一 个 新 的 JSON 文件 。 读 取 的 JSON 文件 格式 如 下 列 
代码 所 示 。 





要 求 输出 的 文件 格式 如 下 : 





整体 的 思路 是 : 首先 通过 fs 模块 来 读 取 JSON 文件 中 的 内 容 ， 通 过 JSON.parse 来 解析 IP 
地 址 的 信息 ， 根 据 IP 地 址 来 获取 城市 的 名 称 和 当地 实时 的 天 气 信息 。 最 后 将 所 有 的 信息 重新 
组 织 ， 并 输出 到 一 个 新 的 JSON 文件 weatherjson。 


5.4.2 引入 基础 模块 


如 前 面 章节 介绍 ， 在 进行 文件 操作 之 前 ， 首 先 要 引入 必要 的 模块 。 下 面 的 代码 用 require 
引入 了 我 们 所 需要 的 所 有 模块 : 





这 里 我 们 引入 了 3 个 模块 ， 分 别 为 : 


(1) 仿 : 从 文件 ip.json 读 取 IP 列表 ， 把 结果 写 入 文件 中 。 
(2) request: 用 来 发 送 HTTP 请 求 ,根据 IP 地 址 获取 GEO 数据 ， 再 通过 GEO 数据 获取 


天 气 数据 。 
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(3) querystring: 用 来 组 装 发 送 请 求 的 url 参数 。 


5.4.3 解析 IP 地 址 信息 


这 里 通过 调用 fs.readFile 读 取 文件 中 的 IP 列表 ， 再 通过 我 们 前 面 介 绍 的 JSON.parse 来 解 
析 JSON 数据 ， 代 码 如 下 : 





5.4.4 通过 公共 服务 获取 城市 和 天 气 信息 


下 面 我 们 首先 用 IP 地 址 查询 到 相应 的 城市 名 称 ， 这 里 需要 利用 telize.com 的 公共 GEO 查 
询 服务 。telize 是 一 个 基于 Nginx 和 Lua 构建 的 REST API， 人 允许 根据 IPv4 和 IPv6 的 地 址 查询 
所 在 地 区 信息 。 在 这 里 我 们 输出 JSON 封装 的 IP 地 理 位 置信 息 ，telize 同时 也 支持 JSON 和 
JSONP 格式 的 输入 。 下 面 的 代码 将 用 IP 地 址 来 查询 地 理 信息 和 天 气 情况 。 
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OpenWeatherMap 服务 提供 了 免费 的 天 气 数据 和 预测 API， 如 包含 当前 天 气 的 地 图 、 一 周 
预报 、 降 水 、 风 、 云 等 来 自 气象 站 的 其 他 数据 ， 并 且 OpenWeatherMap 每 天 从 全 球 超过 40000 
个 气象 站 接收 气象 广播 服务 数据 。 

本 例 中 使 用 OpenWeatherMap 服务 的 API 来 获取 任意 的 天 气 数据 。 其 他 类 别 的 应 用 也 可 以 使 
用 OpenWeatherMap 作为 天 气 数据 源 , 数据 可 以 从 WMS 服务 器 接收 并 可 以 被 嵌入 到 任何 基于 Web 
的 应 用 程序 中 。 更 多 详细 信息 请 参考 OpenWeatherMap 官方 网 址 : http://openweathermap.org/。 


本 文 代码 中 有 一 个 APPID, 做 过 微 信 开 发 的 读者 肯定 都 知道 ， 这 是 一 个 开发 者 ID， 本 
例 中 的 APPID 是 从 OpenWeatherMap 申请 的 开发 者 ID ， 申 请 过 程 可 参考 
https://openweathermap.org/appid。 





5.4.5 遍历 IP 地 址 


到 目前 为 止 , 我 们 通过 公共 服务 已 经 获取 到 地 理 信息 和 天 气 信息 的 接口 , 接 下 来 我 们 还 要 
处 理 多 个 IP 地 址 ， 所 以 我 们 需要 并 行 地 去 读 取 地 理 位 置 并 读 取 相对 应 城市 的 天 气 数据 。 下 面 
的 代码 将 完成 这 部 分 功能 。 














}) 
}) (geo) 
} 
k 
geos2weathers 在 这 里 使 用 了 一 种 比较 简单 的 计算 方法 。remain 用 来 计算 等 待 返回 的 个 数 。 











remain 为 0 表示 并 行 请 求 结束 ， 将 处 理 结果 装 进 一 个 数组 返回 。 





5.4.6 ”将 结果 写 入 weather.json 
将 结果 写 入 weatherjson 的 代码 如 下 ， 这 里 使 用 一 个 for 循环 遍历 每 个 IP 地 址 的 信息 。 


function writeWeather (weathers, callback) { 
var output = [] 
var weather 
// 使 用 for 循环 遍历 每 个 IP 地 址 的 信息 
for (var i = 0; i < weathers.length; i++) { 
weather = weathers [il] 
outpPut .push ({ 
ip: weather.geo.ip, 
weather: weather .weather[0] .main, 
region: weather.geo.region 
0 
} 
// 使 用 fs .writeFile 函数 将 结果 写 入 到 weather.json 中 
fs.writeFile('./weather.json', JSON.stringify(output, null, ' '), callback) 


旦 序 运行 之 后 ， 生 成 的 weatherjson 文件 如 图 5.2 所 示 。 











图 5.2 生成 的 天 气 结果 JSON 文件 
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输出 的 JSON 文件 可 以 通过 解析 输出 到 HTML 中 ， 最 终 在 应 用 程序 中 为 用 户 提供 实时 的 
地 理 位 置信 息 和 当地 的 天 气 情况 。 本 例 我 们 重点 介绍 前 半 部 分 ， 所 以 具体 如 何 显示 类 似 图 5.3 
的 效果 ， 读 者 可 能 还 要 参考 一 些 HTML+CSS 的 技术 ， 这 里 不 再 提供 代码 。 





City of London, GB 
章 8.6 °C 





5.3 输出 效果 参考 图 


司 .5， 温 故 知 新 
学 完 本 章 ， 读 者 需要 回答 : 
1. 打开 文件 和 关闭 文件 使 用 什么 方法 ? 
2. 异步 的 操作 有 哪些 优点 ? 
3. Node.js 是 否 可 以 操作 GBK 或 GB2312 格式 的 文件 ? 
4. 写 入 文件 有 哪 几 种 方法 ? 
5. 文件 读 取 失 败 有 哪 几 种 原因 ， 如 何 进行 定位 ? 
6. 创建 一 个 文件 ， 并 将 0~100 之 间 可 以 被 3 整除 的 数 写 入 该 文件 。 
7. 读 取 一 个 XML 文件 ， 并 将 其 转换 为 纯 文 本 文件 。 
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网 络 是 通信 互联 的 基础 , Nodejs 提供 了 net、 http、dgram 模块 , 分 别 用 来 实现 TCP、HTTP、 
UDP 的 通信 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 

@ TCP 服务 器 和 客户 端的 创建 。 


@ HTTP 的 路 由 控制 思想 。 
@ ”UDP 数据 通信 的 实现 。 


名 .1 构建 TCP 服务 器 


OSI 参考 模型 将 网 络 通信 功能 划分 为 7 层 ， 即 物理 层 、 数 据 链 路 层 、 网 络 层 、 传 输 层 、 会 
话 层 、 表 示 层 和 应 用 层 。TCP 协议 就 是 位 于 传输 层 的 协议 。Nodejs 在 创建 一 个 TCP 服务 器 的 
时 候 使 用 的 是 net〈 网 络 ) 模块 。 


6.1.1 使 用 Node.js 创建 TCP 服务 器 


为 了 使 用 Nodejs 创建 TCP 服务 器 ， 首 先 要 使 用 require(net) 来 加 载 net 模块 ， 然 后 使 用 
net 模块 的 createServer 方 法 就 可 以 轻松 地 创建 一 个 TCP 服务 器 。 


@ options 是 一 个 对 象 参数 值 ,有 两 个 布尔 类 型 的 属性 allowHalfDpen 和 pauseOnConnect。 
这 两 个 属性 默认 都 是 false。 

@ 。 connectionListener 是 一 个 当 客户 端 与 服务 端 建立 连接 时 的 回调 函数 , 这 个 回调 函数 以 
Socket 端口 对 象 作 为 参数 。 


如 下 代码 构建 一 个 TCP 服务 器 。 
【示例 6-1】 
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6.1.2 监听 客户 端的 连接 
使 用 TCP 服务 器 的 listen 方法 就 可 以 开始 监听 客户 端的 连接 : 


port 参数 为 需要 监听 的 端口 号 ， 参 数值 为 0 的 时 候 将 随机 分 配 一 个 端口 号 。 
host 为 服务 器 地 址 。 

backlog 为 连接 等 待 队列 的 最 大 长 度 。 

callback 为 回调 函数 。 


如 下 代码 可 以 创建 一 个 TCP 服务 器 并 监听 18001 端口 。 
【示例 6-2】 





运行 这 段 代码 ， 可 以 在 控制 台 看 到 执行 了 listen 方法 的 回调 函数 ， 如 图 6.1 所 示 。 





图 6.1 执行 listen 的 回调 函数 


可 以 使 用 相应 的 TCP 客户 端 或 者 调试 工具 来 连接 已 经 创建 的 这 个 TCP 服务 器 。 例如， 要 
使 用 Windows 的 Telnet 就 可 以 用 以 下 命令 连接 : 


连接 成 功 后 可 以 看 到 控制 台 打印 了 “someone connects” 字 样 ， 表明 createServer 方法 的 回 
调 函 数 已 经 执行 ， 说 明 已 经 成 功 连接 到 这 个 创建 的 TCP 服务 器 。 

server.listen() 方 法 其 实 触 发 的 是 server 下 的 listening 事件 ， 所 以 也 可 以 手动 监听 listening 
事件 。 如 下 代码 同样 实现 了 创建 一 个 TCP 服务 器 并 监听 18001 端口 的 作用 。 
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【示例 6-3】 





除了 listening 事件 外 ，TCP 服务 器 还 支持 以 下 事件 : 


@ 。 connection: 当 有 新 的 链接 创建 时 触发 ， 回 调 函数 的 参数 为 socket 连接 对 象 。 
@ close: TCP 服务 器 关闭 的 时 候 触 发 ， 回 调 函数 没有 参数 。 
@ error: TCP 服务 器 发 生 错 误 的 时 候 触 发 ， 回 调 函数 的 参数 为 error 对 象 。 


下 列 代码 通过 net.Server 类 来 创建 一 个 TCP 服务 器 ， 添 加 以 上 事件 。 
【示例 6-4】 
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运行 以 上 这 段 代码 并 用 Telnet 等 工具 连接 这 个 创建 的 TCP 服务 器 ， 可 以 发 现 效果 和 【 示 
例 6-3】 代 码 的 效果 一 致 。 
6.1.3 ”查看 服务 器 监听 的 地 址 


当 创建 了 一 个 TCP 服务 器 后 ， 可 以 通过 server.address() 方 法 来 查看 这 个 TCP 服务 器 监听 
的 地 址 ， 并 返回 一 个 JSON 对 象 。 这 个 对 象 的 属性 有 : 


@ port: TCP 服务 器 监听 的 端口 号 。 

@ family: 说 明 TCP 服务 器 监听 的 地 址 是 IPv6 还 是 IPv4。 

@ address: TCP 服务 器 监听 的 地 址 。 

因为 这 个 方法 返回 的 是 TCP 服务 器 监听 的 地 址 信息 ， 所 以 这 个 方法 应 该 在 使 用 了 
server.listen() 方 法 或 者 绑 定 事件 listening 中 的 回调 函数 中 使 用 。 


【示例 6-5】 





console.log('the famaily of server is ' + address.family); 
1D); 


运行 这 段 代 码 可 以 发 现 已 经 在 控制 台 打 印 出 TCP 服务 器 监听 的 地 址 信息 ， 如 图 6.2 所 示 。 





图 6.2 TCP 服务 器 监听 的 地 址 信息 


6.1.4 连接 服务 器 的 客户 端 数量 


创建 一 个 TCP 服务 器 后 ， 可 以 通过 server.getConnections() 方 法 获取 连接 这 个 TCP 服务 器 
的 客户 端 数量 。 这 个 方法 是 一 个 异步 的 方法 ， 回 调 函 数 有 两 个 参数 : 


@ 第 一 个 参数 为 error 对 象 。 
@ 第 二 个 参数 为 连接 TCP 服务 器 的 客户 端 数量 。 


除了 获取 连接 数量 外 ， 也 可 以 通过 设置 TCP 服务 器 的 maxConnections 属性 来 设置 这 个 
TCP 服务 器 的 最 大 连接 数量 。 当 连接 数量 超过 最 大 连接 数量 的 时 候 ， 服 务 器 将 拒绝 新 的 连接 。 
如 下 代码 设置 创建 的 这 个 TCP 服务 器 的 最 大 连接 数量 为 3。 


【示例 6-6】 
/* 引 入 net 模块 */ 


Var net = require('net'); 


/* 创 建 服务 器 */ 

var server = net.createServer (function(socket){ 
console.log('someone connects'); 
/* 设 置 最 大 连接 数量 */ 
server.maxConnections = 37 
server.getConnections (function (err， count) { 

console.log('the count of client is ' + count); 

D); 

Ds; 


/* 设 置 监听 端口 */ 
server.listen(18001,function() { 

console.log('server is listening'); 
1D); 


运行 这 段 代 码 ， 并 尝试 用 多 个 客户 端 连 接 。 可 以 发 现 当 客户 端 连接 数量 超过 3 的 时 候 , 新 
的 客户 端 就 无 法 连接 这 个 服务 器 了 ， 如 图 6.3 所 示 。 
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图 6.3 设置 TCP 服务 器 的 最 大 连接 数量 


6.1.5 获取 客户 端 发 送 的 数据 

上 文 提 到 createServer 方法 的 回调 函数 参数 是 一 个 net.Socket 对 象 〈 服 务 器 所 监听 的 端口 
对 象 ) 。 这 个 对 象 同样 也 有 一 个 address() 方 法 ， 用 来 获取 TCP 服务 器 绑 定 的 地 址 ， 同 样 也 是 
返回 一 个 含有 port、family、address 属性 的 对 象 。 

socket 对 象 可 以 用 来 获取 客户 端 发 送 的 流 数 据 , 每 次 接收 到 数据 的 时 候 触发 data 事件 , 通 
过 监听 这 个 事件 就 可 以 在 回调 函数 中 获取 客户 端 发 送 的 数据 ， 代 码 如 下 : 

【示例 6-7】 
/* 引 入 net 模块 */ 


var net = require('net'); 





/* 创 建 服务 器 */ 


Var server = net.createServer (function(socket){ 


/* 监 听 data 事件 */ 


socket .on('data',function (data) { 


/* 打 印 data*/ 
console.log (data.toSstring()); 
1); 
1); 


/* 设 置 监听 端口 */ 
server.listen(18001,function() { 

console.log('server is listening'); 
DD); 


运行 这 段 代码 之 后 ， 通 过 Telnet 等 工具 连接 后 ， 发 送 一 段 数 据 给 服务 端 ， 在 命令 行 中 就 
可 以 发 现 数据 已 经 被 打印 出 来 了 ， 如 图 6.4 所 示 。 





图 6.4 打印 客户 端 发 送 的 数据 


socket 对 象 除 了 有 data 事件 外 ， 还 有 connect、end、error、timeonut 等 事件 。 
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6.1.6 ”发 送 数据 给 客户 端 
利用 socket.write0 可 以 使 TCP 服务 器 发 送 数据 。 这 个 方法 只 -个 必需 参数 ， 就 是 需要 
发 送 的 数据 ; 第 二 个 参数 为 编码 格式 ， 可 选 。 同 时 ， 可 以 为 这 个 方法 设置 一 个 回调 函数 。 当 有 
户 连接 TCP 服务 器 的 时 候 ， 将 发 送 数据 给 客户 端 ， 代 码 如 下 : 
【示例 6-8】 
/* 引 入 net 模块 */ 


var net = require('net'); 














/* 创 建 服务 器 */ 


Var server = net.createServer (function(socket){ 


/* 获 取 地 址 信息 */ 
var address = server.address(); 
'client, the server address is ' + JSON.stringify(address); 


ll 


var message 


/* 发 送 数据 */ 
socket .write (message, function(){ 
var writeSize = socket.bytesWritten; 
console.log(message + 'has send'); 
console.log('the size of message is ' + writeSize); 
1D); 


/* 监 听 data 事件 */ 
socket.on('data',function (data){ 
console.log (data.toString()); 
Var readSize = socket.bytesRead; 
console.log('the size of data is ' + readSize); 
py 
1); 


/* 设 置 监 听 端 口 */ 
server.listen(18001,function() { 
console.log('server is listening'); 
}); 
运行 这 段 代码 并 连接 TCP 服务 器 ， 可 以 看 到 Telnet 中 收 到 了 TCP 服务 器 发 送 的 数据 ， 
Telnet 也 可 以 发 送 数据 给 TCP 服务 器 ， 如 图 6.5 所 示 。 


":"IPv6","port":18001}has s 





图 6.5 TCP 服务 器 发 送 数 据 


在 上 面 这 段 代 码 中 还 用 到 了 socket 对 象 的 bytesWritten 和 bytesRead 属性 ， 这 两 个 属性 分 
别 代表 着 发 送 数 据 的 字 节 数 和 接收 数据 的 字 节 数 。 
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除了 上 面 这 两 个 属性 外 ，socket 对 象 还 有 以 下 属性 : 


socket.localPort: 本 地 端口 的 地 址 。 
socket.localAddress: 本 地 IP 地 址 。 
SocketremotePort: 远程 端口 地 址 。 
socketremoteFamily: 远程 IP 协议 族 。 
@ socketremoteAddress: 远程 的 IP 地 址 。 


以 下 这 段 代 码 就 将 这 些 属 性 打印 在 了 控制 台 。 
【示例 6-9】 





运行 这 段 代码 并 连接 TCP 服务 器 ， 可 以 在 命令 行 中 看 到 图 6.6 所 示 的 信息 。 
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图 6.6 _ socket 的 相关 属性 


构建 TCP 客户 端 
Nodejs 在 创建 一 个 TCP 客户 端的 时 候 同 样 使 用 的 是 net〈 网 络 ) 模块 。 


6.2.1 使 用 Node.js 创建 TCP 客户 端 

为 了 使 用 Nodejs 创建 TCP 客户 端 ， 首 先 要 使 用 require('net") 来 加 载 net 模块 。 创 建 一 个 
TCP 客户 端 只 需要 创建 一 个 连接 TCP 客户 端的 socket 对 象 即 可 : 
/* 引 入 net 模块 */ 


Var net = require('net'); 


/* 创 建 客户 端 */ 
Var client = new net.Socket(); 
创建 一 个 socket 对 象 的 时 候 可 以 传 入 一 个 json 对 象 。 这 个 对 象 有 以 下 属性 : 
@ fd: 指定 一 个 存在 的 文件 描述 符 ， 默 认 值 为 null。 
@ readable: 是 否 允 许 在 这 个 socket 上 读 ， 默 认 值 为 false。 
@ writeable: 是 否 允 许 在 这 个 socket 上 写 ， 默 认 值 为 false。 
@ allowHalfOpen: 该 属性 为 false 时 ，TCP 服务 器 接收 到 客户 端 发 送 的 一 个 FIN 包 后 将 
会 回 发 一 个 FIN 包 ; 该 属性 为 true 时 ，TCP 服务 器 接收 到 客户 端 发 送 的 一 个 FIN 包 
后 不 会 回 发 FIN 包 。 


6.2.2 连接 TCP 服务 器 


创建 了 一 个 socket 对 象 后 使 用 socket 对 象 的 connect0) 方 法 就 可 以 连接 一 个 TCP 服务 器 
例如 ， 连 接 【 示 例 6-9】 中 创建 的 TCP 服务 器 ， 可 以 使 用 以 下 代码 。 


【示例 6-10】 
/* 引 入 net 模块 */ 


Var net = require('net'); 


/* 创 建 客户 端 */ 
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运行 【示例 6-9】 的 代码 启动 TCP 服务 器 后 运行 【示例 6-10】 这 段 代 码 ， 可 以 在 命令 行 中 
发 现 打印 了 一 些 字样 ， 说 明 connect0 方 法 的 回调 函数 已 经 执行 了 ， 即 已 经 成 功 连接 上 TCP 服 
务 器 ， 如 图 6.7 所 示 。 


图 6.7 连接 TCP 服务 器 


6.2.3 获取 从 TCP 服务 器 发 送 的 数据 


在 6.1 节 中 已 经 介绍 了 一 个 socket 对 象 有 data、error、close、end 等 事件 ， 因 此 也 可 以 通 
过 监听 data 事件 来 获取 从 TCP 服务 器 发 送 的 数据 : 


【示例 6-11】 





运行 【示例 6-8】 的 代码 启动 TCP 服务 器 后 ,运行 上 面 这 段 代码 ， 可 以 发 现 命令 行 中 已 经 
输出 了 来 自 服务 端的 数据 ， 说 明 此 时 已 经 实现 了 服务 端 和 客户 端 之 间 的 通信 。 


6.2.4 ”向 TCP 服务 器 发 送 数据 
因为 TCP 客户 端 是 一 个 socket 对 象 6.1 节 中 提 到 的 write() 方 法 以 及 localPort localAdress 


等 属性 依旧 可 用 ， 所 以 可 以 使 用 以 下 代码 来 向 TCP 服务 器 发 送 数据 : 


【示例 6-12】 
/* 引 入 net 模块 */ 


Var net = require('net'); 


/* 创 建 客户 端 */ 


var Client = net.Socket (); 


/* 设 置 连接 的 服务 器 */ 
client.connect (18001, '127.0.0.1', function(){ 


console.log('connect the server'); 


/* 发 送 数 据 */ 
client.write('message from client'); 
1); 


/* 监 听 data 事件 */ 
client.on('data', function(data) { 

console.log('the data of server is ' + data.toString()) 
1); 


/* 监 听 end 事件 */ 
client.on('end', function(){ 


console.log('data end'); 








1); 
运行 【示例 6-8】 的 代码 启动 TCP 服务 器 后 ,运行 上 面 这 段 代码 ， 可 以 发 现 服务 器 已 经 接 
收 到 客户 端的 数据 ， 客 户 端 也 已 经 接收 到 服务 端的 数据 ， 如 图 6.8 和 图 6.9 所 示 。 


$ node 6-12 
connect the server 
t data of 是 


is client，the server address is {f"addre 





图 6.8 ”TCP 客户 端 


node 6-8 
r is listening 
the server address is {"address":" ":"IPv6","port":18001}has s 


of message is 75 
om client 
of data is 19 





图 6.9 ”TCP 服务 端 


流 的 形式 将 文件 中 的 数据 发 送出 去 ,相关 的 知识 可 以 在 文 








然 客户 端 和 服务 端 也 可 以 通 
件 模 块 中 进行 学 3 
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折 . 构建 HTTP 服务 器 


在 如 今 Web 大 行 其 道 的 时 代 ， 支 撑 无 数 网 页 运行 的 正 是 HTTP 服务 器 。Nodejs 之 所 以 受 
到 大 量 Web 开发 者 的 青睐 ， 与 Nodejs 有 能 力 自 己 构建 服务 器 是 分 不 开 的 。 
6.3.1 创建 HTTP 服务 器 


在 本 书 的 第 4 章 中 已 经 提 到 HTTP 服务 器 。 只 需要 使 用 以 下 代码 就 可 以 创建 一 个 简单 的 
HTTP 服务 器 。 


【示例 6-13】 





通过 这 段 代码 可 以 在 浏览 器 中 看 到 创建 的 服务 器 发 送 给 浏览 器 的 数据 ,在 第 4 章 中 已 经 说 
明了 http 模块 的 主要 应 用 ， 这 里 不 再 陈述 ， 将 重点 放 在 HTTP 服务 器 优化 上 。 

上 面 这 个 HTTP 服务 器 只 是 实现 了 将 一 行 字符 串 的 数据 发 送 给 浏览 器 。 很 明显 ， 如 果 服 务 
器 仅仅 能 发 送 一 些 字符 串 ， 那 几乎 是 不 可 用 的 ， 因 此 需要 对 上 面 这 个 服务 器 的 功能 进行 拓展 。 
通过 文件 模块 将 文件 读 取 并 发 送 给 浏览 器 就 是 一 个 不 错 的 选择 ， 将 上 面 的 代码 修改 为 以 下 
代码 。 


【示例 6-14】 
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同时 在 同 级 目录 中 创建 一 个 名 为 index.html 的 文件 ， 写 入 以 下 代码 : 


运行 代码 ， 利 用 浏览 器 访问 localhost:3000 这 个 地 址 ， 如 图 6.10 所 示 。 
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Hello,Node.js 


图 6.10 HTTP 服务 器 发 送 文件 信息 


需要 提 及 的 是 ， 这 里 HTTP 服务 器 在 发 送 给 浏览 器 的 头 部 信息 中 将 content-type 修改 为 了 
text/html。content-type 的 作用 就 是 用 来 表示 客户 端 或 者 服务 器 传输 数据 的 类 型 ， 服 务 器 和 客户 
端 通过 这 个 值 来 做 相应 的 解析 。 如 果 将 这 个 值 修改 为 原来 的 texyplain， 浏 览 器 中 将 显示 
index.htm 文件 中 的 所 有 代码 ， 而 这 显然 不 是 我 们 所 希望 的 。 


6.3.2 HTTP 服务 器 的 路 由 控制 


上 一 节 中 的 服务 器 虽然 已 经 可 以 通过 读 取 文 件数 据 来 发 送 给 客户 端 了 ,但 是 并 没有 做 任何 
的 路 由 控制 , 在 浏览 器 中 输入 任何 URL 都 将 返回 同样 的 内 容 。 简 单 来 说 ,路 由 就 是 URL 到 函 
数 的 映射 。 

要 做 到 路 由 控制 ， 通 过 上 面 的 学 习 可 以 预想 到 ， 需 要 设 定 的 必然 有 content-type。 这 里 假 
定 只 需要 处 理 html、js、css 和 图 片 文件 ， 创 建 一 个 名 为 mime.js 的 文件 ， 写 入 以 下 代码 : 





需要 做 到 路 由 控制 ， 也 就 需要 知道 用 户 请 求 的 URL 地 址 ， 也 就 是 req.url， 所 以 通过 这 个 
属性 获取 到 URL 后 也 就 可 以 对 路 由 进行 控制 了 ， 如 以 下 代码 所 示 。 


【示例 6-15】 





人 


这 里 通过 req.url 对 路 径 处 理 判 断 来 返回 不 同 的 资源 ， 从 而 做 到 简单 的 路 由 控制 。 


.A 利用 UDP 协议 传输 数据 与 发 送 消息 


前 文中 所 提 到 的 TCP 数据 传输 是 一 种 可 靠 的 数据 传输 方式 ， 在 数据 传输 之 前 必须 建立 客 
户 端 与 服务 端 之 间 的 连接 。UDP 是 一 种 面向 非 连 接 的 协议 , 所 以 其 传输 速度 比 TCP 更 加 快速 。 
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6.4.1 创建 UDP 服务 器 


为 了 使 用 Nodejjs 创建 UDP 服务 器 ， 首 先 要 使 用 require('dgram') 加 载 dgram 模块 。 

使 用 dgram 模块 中 的 createSocket() 方 法 来 创建 一 个 UDP 服务 器 。 这 个 方法 接收 一 个 必需 
参数 和 一 个 可 选 参数 , 必需 参数 是 一 个 表示 UDP 协议 的 类 型 , 可 指定 为 “udp4” 或 者 “udp6”， 
具体 如 下 : 





这 个 方法 中 的 可 选 参数 为 一 个 回调 函数 ， 是 UDP 服务 器 接收 数据 时 触发 的 回调 函数 ， 可 
接收 两 个 参数 ， 一 个 为 接收 到 的 数据 ， 另 一 个 为 存放 发 送 者 信息 的 对 象 ， 具 体 如 下 : 





rinfo 对 象 的 属性 及 属性 值 如 下 : 


@ address: 表示 发 送 者 地 址 。 

@@ family: 表示 发 送 者 使 用 的 地 址 为 “ipv4” 或 者 “ipv6”。 

@ port 表示 发 送 者 的 端口 号 。 

@ size: 表示 发 送 者 发 送 数据 的 字 节 数 大 小 。 

创建 完 一 个 socket 端口 对 象 后 还 需要 绑 定 一 个 端口 号 才能 创建 UDP 服务 器 ， 可 利用 
socket.bind() 方 法 绑 定 一 个 端口 号 。 这 个 方法 接收 一 个 必需 参数 、 两 个 可 选 参数 。 必 有 需 参 数 为 
需要 绑 定 的 端口 号 ， 两 个 可 选 参数 为 地 址 和 回调 函数 ， 具 体 如 下 : 





人 








这 是 一 个 简单 的 UDP 服务 器 , 与 net 和 http 方法 类 似 , 因为 createSocket 方法 返回 的 是 一 
个 socket 对 象 。 一 个 socket 对 象 主要 有 以 下 事件 : 


message: 接收 数据 时 触发 。 
listening: 开始 监听 数据 报 文 时 触发 。 
close: 关闭 socket 时 触发 。 

error: 发 生 错误 时 触发 。 


显然 上 文中 使 用 createSocket() 方 法 中 的 回调 函数 就 是 监听 message 事 件 , 因此 使 用 createSocket() 
方法 时 可 以 不 指定 回调 函数 ， 直 接 显 式 监听 message 事件 同样 可 以 达到 相应 的 效果 : 





将 事件 综合 使 用 则 如 下 代码 所 示 。 








一 个 socket 对 象 主要 有 以 下 方法 : 


bind0: 绑 定 端口 号 。 

send(): 发 送 数据 。 

address(): 获取 该 socket 端口 对 象 相关 的 地 址 信息 。 
close(): 关闭 socket 对 象 。 


bind() 方 法 在 上 文中 已 经 介绍 ，send() 方 法 用 来 发 送 数据 ， 其 完整 的 参数 使 用 如 下 : 


buf 代表 需要 发 送 的 消息 ， 可 以 是 缓存 对 象 或 者 字符 串 。 

offset 是 一 个 整数 数字 ， 代 表 消 息 在 缓存 中 的 偏 移 量 。 

length 是 一 个 整数 数字 ， 代 表 消 息 的 比特 数 。 

port 代表 发 送 数据 的 端口 号 。 

address 代表 接收 数据 的 socket 端口 对 象 的 地 址 。 

callback 为 数据 发 送 完毕 所 需 调 用 的 回调 函数 。 这 个 回调 函数 的 第 一 个 参数 是 error 
对 象 ， 第 二 个 参数 为 数据 发 送 的 比特 数 。 


因此 使 用 这 个 方法 看 起 来 会 像 是 这 样 : 
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6.4.2 创建 UDP 客户 端 


因为 UDP 客户 端 本 质 上 其 实 也 是 一 个 socket 端口 对 象 ,所 以 同样 可 以 通过 创建 一 个 socket 
对 象 来 构建 UDP 客户 端 ， 这 样 得 到 的 是 一 个 socket 对 象 ， 所 以 同样 可 以 使 用 上 述 介绍 的 相关 
方法 。 如 下 代码 就 可 以 实现 一 个 简单 的 UDP 客户 端 : 
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因此 通过 创建 一 个 socket 对 象 作为 客户 端 和 一 个 socket 对 象 作 为 服务 端 就 可 以 实现 UDP 
协议 的 通信 了 。 
【示例 6-16】 


【示例 6-17】 





/* 发 送 数据 */ 
socket .send (message, 0, message.length, 41234, 'localhost', function (err, bytes) 
{ 
if(err) 1{ 
console.log (err); 
return; 
1 
console.log('client send ' + bytes + 'message') 7 
}) 7 


/* 监 听 message 事件 */ 

socket.on('message', function (msg, rinfo) { 
console.log("some message form server"); 

1); 


运行 【示例 6-16】 和 【示例 6-17】 的 代码 ， 依 次 启动 UDP 服务 器 和 UDP 客户 端 ， 可 以 
发 现 已 经 实现 了 UDP 服务 器 和 UDP 客户 端的 通信 ， 如 图 6.11 和 图 6.12 所 示 。 





图 6.11 UDP 服务 器 





图 6.12 UDP 客户 端 


温 故 知 新 


学 完 本 章 ， 读 者 需要 回答 : 


. 如 何 通过 net 模块 创建 一 个 TCP 服务 器 ? 

如 何 创建 一 个 HTTP 服务 器 和 HTTP 客户 端 ? 
. HTTP 路 由 控制 的 思想 是 什么 ? 

. UDP 中 socket 对 象 有 哪些 常用 的 方法 ? 














上 
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数据 库 在 互联 网 中 的 重要 性 不 言 而 喻 。 数据 库存 放 着 大 量 的 信息 ， 是 很 多 互联 网 公司 的 命 
脉 。 目 前 运用 广泛 的 有 关系 型 数据 库 和 非 关系 型 数据 库 。MySQL 数据 库 是 关系 型 数据 库 的 杰 
出 代表 ，MongoDB 则 是 近 几 年 大 热 的 非 关系 型 数据 库 。 本 章 将 主要 介绍 Node.js 与 这 两 种 数 
据 库 的 连接 和 交互 操作 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 

@ 连接 MySQL 数据 库 并 进行 操作 。 

@ 连接 MongoDB 数据 库 并 进行 操作 。 

@ 了 解数 据 库 基础 知识 。 








使 用 mongoose 连接 MongoDB 


MongoDB 是 一 个 基于 分 布 式 文件 存储 的 数据 库 ， 由 C++ 语言 编写 , 目的 是 让 Web 应 用 提 
供 可 拓展 的 高 性 能 数据 存储 解决 方案 。 


7.1.1 MongoDB 介绍 


目前 ，MongoDB 是 非 关 系 型 数据 库 中 功能 最 丰富 、 最 像 关系 型 数据 库 的 产品 ,MongoDB 
由 10gen 团队 在 2007 年 发 展 ，2009 年 2 月 首 度 推出 。MongoDB 支持 的 数据 结构 类 似 于 json 
的 bson 格式 。 这 种 数据 结构 非常 松散 ， 可 以 很 方便 地 存储 比较 复杂 的 数据 类 型 。MongoDB 的 
主要 特点 是 高 性 能 、 易 存储 、 易 使 用 、 易 部 署 。 

MongoDB 的 最 小 数据 单位 是 文档 〈 类 似 于 关系 型 数据 库 中 的 行 ) 。 文 档 是 由 多 个 键 及 其 
对 应 的 值 组 成 的 (类 似 于 json) ， 一 组 文档 共同 组 成 了 一 个 集合 。 集 合 类 似 于 关系 型 数据 库 中 
的 表 ， 但 是 一 个 集合 中 的 文档 可 以 是 各 式 各 样 的 ， 一 组 集合 就 组 成 了 一 个 数据 库 。MongoDB 
可 以 承载 多 个 数据 库 ， 这 些 数据 库 可 以 看 作 是 相互 独立 的 。 

(1) MongoDB 的 官方 网 站 是 https://www.mongodb.com/。 读 者 可 以 在 MongoDB 官方 网 
站 的 下 载 页 面 https:/www.mongodb.com/download-center 选择 相应 的 版 本 进行 下 载 ， 如 图 7.1 
所 示 。 
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Installation Package: 


由 DOWNLOAD Im 可 


Binany inzalasion Insbuctions | All Verson Sinarie: 





图 7.1 MongoDB 下 载 页 面 

(2) 在 这 里 以 Windows 版 本 为 例 ， 将 下 载 下 来 的 MongoDB 软件 按照 常规 软件 的 步骤 安 

装 即 可 。 需 要 提醒 的 是 ， 在 安装 过 程 中 ，MongoDB 默认 安装 在 C 盘 ， 可 以 在 安装 过 程 中 选择 

安装 的 路 径 〈 因 为 MongoDB 的 操作 需要 用 到 这 个 路 径 ， 所 以 读者 要 选择 一 个 合适 的 路 径 进行 
安装 ) 如 图 7.2 和 图 7.3 所 示 。 

部 “Mongop83412006Rz2plus ssL(54bi setup -本 到 


choose Setup Type 
Choose the setup hpe that bestsuis your needs 


Conpkte 


A rogr an feanures wl be nstaled Requres the most dik space. 
Recommerded for most ur 








Gstom 
Mows uacra to chocac which program feotres val be iratelec and where 
hey wl be netaled Recommenced for advanced veer 




















Custom Setup 
Select the way you vant features to be nstaled. 





Chck theicons n the ree below to change the way feaiures wl be nstaled 




















7.3 MongoDB 选择 Browse 自 定义 路 径 
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(3) 安装 完成 后 ,需要 配置 数据 存储 的 文件 夹 和 MongoDB 的 日 志文 件 夹 。 在 MongoDB 
安装 的 路 径 中 新 建 一 个 名 为 db 的 文件 夹 作为 数据 库存 储 的 文件 夹 ， 同 时 新 建 一 个 名 为 
mongolog 的 文件 夹 作为 日 志文 件 存 储 的 文件 夹 ， 在 db 文件 夹 的 同 级 目录 下 新 建 一 个 名 为 
mongo.config 的 文件 作为 配置 文件 ， 写 入 以 下 内 容 : 


此 时 ， 整 个 目录 结构 如 图 7.4 所 示 。 








CONFIG 文件 





图 7.4 MongoDB 配置 目录 
(4) 打开 CMD 工具 ， 输 入 以 下 命令 ， 就 可 以 启动 MongoDB 了 : 


这 里 仅仅 是 对 MongoDB 进行 简单 的 介绍 , 更 多 知识 读者 可 以 通过 阅读 相关 的 书籍 进行 学 
习 与 掌握 。 


7.1.2 ”使 用 mongoose 连接 MongoDB 


mongoose 是 一 个 基于 node-mongodb-native 开发 的 MongoDB 的 Nodejs 驱动 ， 可 以 很 方 
便 地 在 异步 环境 中 使 用 。 

mongoose 的 GitHub 地 址 是 https://github.com/Automattic/mongoose。mongoose 的 官方 网 站 
是 http://mongoosejs.com/， 读 者 可 以 在 mongoose 的 官方 网 站 中 阅读 相应 的 说 明和 官方 文档 。 

使 用 mongoose 这 个 模块 前 首先 需要 通过 NPM 安装 这 个 模块 : 


mongoose 模块 通过 connect() 方 法 与 MongoDB 创建 连接 。connect() 方 法 中 需要 传递 一 个 
URI 地 址 ， 用 来 说 明 需 要 连接 的 MongoDB 数据 库 。 如 下 代码 就 和 本 地 的 MongoDB 数据 库 
article 建立 了 连接 。 


【示例 7-1】 
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【代码 说 明 】 

connect() 方 法 创建 MongoDB 连接 ， 回 调 函 数 中 err 为 参数 ， 出 现 连接 错误 则 打印 出 
“connect failed”， 连 接 成 功 则 打印 出 “connect success”。 

运行 这 段 代 码 ， 如 果 MongoDB 服务 已 经 正常 开启 ， 就 会 在 控制 台 打 印 出 “connect 
success” 字 样 。 

需要 说 明 的 是 ，connect() 方 法 中 uri 参数 的 完整 示例 应 该 是 : 


@ user 代表 MongoDB 的 用 户 名 。 
@ pass 代表 用 户 名 对 应 的 密码 。 
@ port 代表 MongoDB 服务 的 端口 号 。 


7.1.3 使 用 mongoose 操作 MongoDB 


mongoose 中 的 一 切 由 schema 开始 。schema 是 一 种 以 文件 形式 存储 的 数据 库 模型 骨架 ， 
并 不 具备 数据 库 的 操作 能 力 。schema 中 定义 了 model 中 的 所 有 属性 ， 而 model 则 是 对 应 一 个 
MongoDB 中 的 collection。 以 下 代码 定义 了 一 个 schema 并 且 注 册 成 了 一 个 model。 


【示例 7-2】 





107 


Node js 开发 实战 着 


【代码 说 明 】 

这 段 代码 通过 实例 化 一 个 mongoose.Schema() 对 象 定义 一 个 model 的 所 有 属性 ， 类 似 于 关 
系 型 数据 库 中 的 字段 和 字段 的 数据 类 型 。schema 合法 的 类 型 有 String、 Number、Date、Buffer、 
Boolean、Mixed、Objectid 和 Array。mongoose 中 通过 mongoose.model() 方 法 注册 一 个 model。 

在 mongoose 中 可 以 使 用 save 方法 将 一 个 新 的 文档 插入 到 collection 中 。 


【示例 7-3】 





const Article = mongoose.model ('Article'); 
Var art = new Articlel({ 
title: 'node.js', 
author: "node'y 
content: 'node.js is great!', 
PublishTime: new Date () 
Fe 


/* 将 文档 插入 到 集合 中 */ 
art.save (function (err) { 
if(err) { 
console.log('save filed'); 
console.log (err); 
}elsef 
console.log('save successed'); 


1); 

【代码 说 明 】 

这 段 代码 调用 名 为 Article 的 model， 之 后 定义 了 一 个 Article 的 文档 ， 最 后 使 用 save 将 记 
录 插 入 到 相应 的 collection 中 。save() 方 法 中 的 回调 函数 监听 是 否 出 错 。 

运行 这 段 代 码 ， 在 MongoDB 运行 正常 的 情况 下 ， 控 制 台 将 输出 “save successed” 字 样 。 

可 以 在 控制 台 对 MongoDB 进行 操作 来 查看 MongoDB 中 是 否 存在 这 样 一 条 记录 ， 连 接 完 
MongoDB 后 打开 控制 台 ， 输 入 以 下 命令 切换 至 article 数据 库 : 





use article 
切换 成 article 数据 库 后 可 以 使 用 以 下 命令 来 查看 article 这 个 数据 库存 在 的 所 有 collection: 
Show collections 


这 时 ， 可 以 看 到 控制 台中 存在 一 个 名 为 articles 的 collection， 如 图 7.5 所 示 。 





图 7.5 查看 数据 库 中 的 collection 


这 时 ， 通 过 以 下 命令 可 以 查看 这 个 名 为 articles 的 collection 中 的 所 有 文档 : 
db .articles.find() 


如 果 刚 才 的 这 个 文档 插入 成 功 ， 控 制 台 就 将 会 显示 这 个 文档 ， 如 图 7.6 所 示 。 





图 7.6 文档 插入 成 功 
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名 为 articles 的 collection 中 出 现 了 插入 的 这 个 文档 ,说明 MongoDB 中 的 确保 存 了 刚刚 插 
入 的 这 条 记录 。 

当然 ， 使 用 mongoose 同样 可 以 查询 相应 的 数据 。 如 下 代码 的 功能 就 是 将 articles 这 个 
collection 中 的 所 有 文档 查询 出 来 。 


【示例 7-4】 


【代码 说 明 】 





这 段 代 码 通过 find() 方 法 查找 相应 的 数据 记录 。find() 方 法 中 的 第 一 个 参数 是 一 个 json 对 











象 ， 定 义 查找 的 条 件 ， 第 二 个 参数 为 回调 函数 。 回 调 函 数 中 的 第 一 个 参数 是 error， 第 二 个 参 
数 是 查询 的 结果 。 
运行 这 段 代 码 ， 可 以 发 现 控制 台 输 出 了 相应 的 数据 记录 ， 如 图 7.7 所 示 。 








d477afb0， 





图 7.7 mongoose 查询 记录 


在 find() 方 法 中 的 第 一 个 参数 中 可 以 传 入 筛选 条 件 ， 以 便 更 加 精确 地 查找 出 需要 查找 的 数 
据 。 现 将 find() 方 法 的 代码 修改 为 以 下 代码 。 


【示例 7-5】 
Article.find({title:'node.js'},function(err, docs) { 
ifl(lerr) { 
console.log('error'); 
return; 


} 
console.log("result: " + docs); 
i 


运行 这 段 代 码 同样 可 以 查询 出 记录 。 

与 find 方法 类 似 的 还 有 findOne() 方 法 ，find() 方 法 是 查询 完 所 有 符合 要 求 的 数据 后 返回 ， 
而 findOne() 方 法 则 是 查询 一 条 数据 ， 返 回 的 是 查询 得 到 的 第 一 条 数据 。 

在 mongoose 中 可 以 直接 在 查询 记录 后 修改 记录 的 值 ， 修 改 后 直接 调用 保存 即 可 。 如 下 代 
码 查 询 数 据 后 直接 修改 数据 的 title 值 为 javascript: 

【示例 7-6】 
/* 引 入 mongoose 模块 */ 


const mongoose = require('mongoose'); 


/* 定 义 mongodb 地 址 */ 


const uri = 'mongodb://localhost/article'; 
/* 连 接 mongodb*/ 
mongoose .connect (uri, function(err) { 


ifl(err) { 
console.lgo (err); 


]}) 
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/* 定 义 Schema*/ 
const ArticleSchema = new mongoose.Schema({ 
title: String, 
author: String, 
content: String, 
PublishTime: Date 
1); 
mongoose.model ('Article',ArticleSchema); 


const Article = mongoose.model ('Article'); 


/* 查 询 mongodb*/ 
Article.find({title:'node.js'},functionl(err, docs) 
if(err) { 


console.log('error'); 


return; 
} 
/* 修 改 数据 */ 
docs [0] .title = 'javascript'; 
/* 保 存 修改 后 的 数据 */ 


docs[0] .save(); 
console.log("result: " + docs); 


1); 


1 


同样 ， 在 命令 行 中 查询 记录 MongoDB， 可 以 发 现 原来 这 个 文档 中 的 title 值 已 经 被 修改 ， 


如 图 7.8 所 示 。 


> db.articles ] 
"id" : Ob ( a01f9 707d477afb0")， 
hor”: "node™”, "co : s great! ”， 


7-01-14T10:48: 


"title” : "jav 
"publishTime" 


ascript"， "auft 
: ISODate("20 





图 7.8 ”mongoose 修改 数据 


类 似 于 修改 数据 ， 删 除 MongoDB 的 文档 也 可 以 在 查询 出 文档 后 直接 调用 remove 方法 。 


如 下 代码 可 以 删除 articles 集合 中 的 所 有 文档 。 


【示例 7-7】 
/* 引 入 mongoose 模块 */ 


const mongoose = require ('mongoose') 


/* 定 义 mongodb 地 址 */ 


const uri = 'mongodb://localhost/article'; 
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只 有 单个 文档 可 以 使 用 remove( 方 法 ， 因 为 find() 方 法 返回 的 是 一 个 符合 查询 条 件 的 所 有 
文档 组 成 的 数组 ， 所 以 这 里 调用 数组 的 forEach() 方 法 逐个 删除 所 有 的 文档 。 同 样 ， 在 命令 
行 中 查询 记录 MongoDB， 可 以 发 现 原来 articles 这 个 集合 的 所 有 文档 已 经 为 空 了 。 





以 上 的 知识 实现 了 使 用 mongoose 对 MongoDB 数据 库 进 行 简单 的 增删 查 改 。 更 多 关于 
mongoose 的 使 用 ， 读 者 可 以 通过 阅读 mongoose 的 官方 文档 进行 学 习 与 掌握 。 
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7.1 节 提 到 mongoose 模块 是 基于 node-mongodb-native 开发 的 MongoDB 的 Nodejs 驱动 ， 
同样 使 用 node-mongodb-native 这 个 原生 MongoDB 驱动 也 可 以 对 MongoDB 进行 相应 的 操作 。 
node-mongodb-native 模块 的 GitHub 地 址 是 https://github.com/mongodb/node-mongodb-native， 
官方 网 站 为 http://mongodb.github.io/node-mongodb-native/， 读 者 可 以 在 官方 网 站 查看 相应 的 说 
明和 文档 进行 学 习 。 


7.2.1 使 用 node-mongodb-native 连接 MongoDB 
使 用 node-mongodb-native 这 个 模块 前 需要 通过 NPM 安装 这 个 模块 : 


node-mongodb-native 通过 connect() 方 法 传递 一 个 URI 地 址 ， 用 来 说 明 需 要 连接 的 
MongoDB 数据 库 。 如 下 代码 即 和 本 地 的 MongoDB 数据 库 student 建立 了 连接 。 


【示例 7-8】 





【代码 说 明 】 
为 mongoose 是 基于 node-mongodb-native 开发 的 ， 所 以 两 者 的 API 还 是 有 相似 的 地 方 。 
运行 以 上 这 段 代 码 ， 如 果 MongoDB 运行 正常 ， 将 会 打印 出 “connect success” 字 样 。 


7.2.2 ”使 用 node-mongodb-native 操作 MongoDB 


使 用 node-mongodb-native 驱动 需要 注意 的 是 每 次 操作 完 MongoDB 都 应 该 调用 close 方法 
来 关闭 MongoDB， 和 否则 会 影响 其 他 代码 对 MongoDB 的 操作 。 利 用 insertOne 方法 可 以 插入 一 
条 数据 ， 如 前 面 提 到 的 一 样 ，node-mongodb-native 插入 的 数据 依旧 是 json 格式 ， 代 码 如 下 : 
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【示例 7-9】 





【代码 说 明 】 

这 段 代 码 将 一 个 名 为 jack 的 学 生 数 据 插 入 到 student 数据 库 下 的 student 集合 中 , 整个 过 程 
是 打开 数据 库 一 打开 集合 一 插入 数据 一 关闭 数据 库 。 这 里 需要 说 明 的 是 , 无 论 数 据 是 否 插 入 成 
功 ， 在 打开 MongoDB 之 后 都 应 该 关闭 ， 否 则 将 影响 其 他 代码 对 MongoDB 数据 库 的 操作 。 

运行 这 段 代码 ， 在 MongoDB 数据 库 运行 正常 的 情况 下 将 打印 出 undefined。 这 是 因为 这 
是 插入 数据 操作 ， 并 没有 文档 会 被 查询 出 来 ， 所 以 console.log(doc[0]); 打印 出 undefined。 同 
样 ， 通 过 命令 行 工 具 可 以 查询 出 student 数据 库 中 的 student 集合 已 经 存在 这 样 一 条 记录 ， 如 图 
7.9 所 示 。 





lent . find( 
jectId( 





图 7.9 通过 命令 查看 数据 
利用 node-mongodb-native 提供 的 findOne 方法 也 可 以 将 这 条 数据 查询 出 来 ， 如 下 代码 所 示 。 


【示例 7-10】 
/* 引 入 模块 */ 
Var MongoClient = require('mongodb') .MongoClient; 
var Db = require('mongodb') .Db; 
Var server = require('mongodb') .Server; 


Var studentDb = new Dbl('student', new server('localhost', '27017°')); 


/* 打 开 数据 库 */ 
StudentDb .open (function(err, db) { 
ifl(lerr) { 
console.log('open err'); 
console.log (err); 


return; 
} 
/* 打 开 和 集合 */ 
db.collection('student', functionl(err, collection) { 
/* 出 错 则 关闭 数据 库 */ 
if(err) { 
console.log('collection error'); 
studentDb.close(); 
console.log (err); 
return; 
} 
总 找 六 档 x/ 
collection.findone({}, function(err, doc) { 
/* 关 闭 数据 库 */ 
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studentDb.close(); 

if(err) { 
console.log('document error'); 
consle.log (err); 
return; 

} 

console.log (doc); 

]}) 7 
]}) 7 
1); 


【代码 说 明 】 

整个 过 程 也 是 按照 打开 数据 库 一 打开 集合 一 查询 数据 一 关闭 数据 库 这 个 流程 严格 执行 的 。 
整 段 代码 依旧 严格 遵循 打开 MongoDB 数据 后 必须 关闭 的 原则 。 

运行 这 段 代 码 , 在 MongoDB 数据 库 运 行 正常 的 情况 下 ,将 会 打印 出 jack 这 条 数据 ， 如 图 
7.10 所 示 。 


: 587b94f71d8a2b258cb40ff2， 
"1101", 





图 7.10 利用 findOne() 方 法 查询 数据 


node-mongodb-native 模块 也 支持 一 次 插入 多 条 数据 和 查询 多 条 数据 ， 只 需要 使 用 
insertMany() 和 find() 方 法 即 可 。 其 中 ,在 insertMany 中 插入 多 条 数据 时 ， 只 要 将 这 些 数据 组 成 
-个 数组 传递 给 insertMany 方法 即 可 。 如 下 代码 就 一 次 性 插入 了 三 条 记录 。 


【示例 7-11】 
/* 引 入 模块 */ 
Var MongoClient = require('mongodb') .MongoClient; 
Var Db = require('mongodb') .Db; 
Var server = require('mongodb') .Server; 
Var studentDb = new Db('student', new server('localhost', '27017°')); 


/* 定 义 数 据 */ 
var Student1 = { 
0 1201 

name: ' 张 三 '， 
age:13 

}; 

var student2 = { 
1 1202y 
name: ' 李 四 '， 
age:14 


Ta 


Node.js 开发 实战 有 


【代码 说 明 】 
运行 这 段 代 码 , 在 MongoDB 运行 正常 的 情况 下 , 可 以 发 现 控制 台 打 印 出 “insert success” 
字样 。 
利用 find() 方 法 可 以 验证 MongoDB 是 否 真 的 存在 刚刚 插入 的 这 些 数据 。 使 用 find 方法 之 
后 需要 使 用 toArray() 方 法 将 这 些 数 据 转化 为 一 个 数组 。 以 下 代码 可 以 查询 出 student 数据 库 下 
student 集合 中 所 有 的 数据 记录 。 
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【示例 7-12】 





if(err) 1{ 
console.log('document error') 7 
consle.log (err); 
return; 

} 

console.log (docs); 

]) 7 
]) 7 
]) 


【代码 说 明 】 


运行 这 段 代码 ， 在 MongoDB 运行 正常 的 情况 下 ， 可 以 发 现 所 有 的 数据 都 已 经 组 织 成 


.个 
| 


数组 ， 刚 刚 的 数据 也 在 这 个 数组 内 ， 说 明 上 面 的 插入 操作 和 查询 操作 都 是 成 功 的 ， 如 图 7.11 


所 示 。 





图 7.11 利用 find() 方 法 查询 数据 


使 用 node-mongodb-native 模块 提供 的 deleteOne() 方 法 可 以 对 数据 进行 删除 ， 与 findOne() 
方法 类 似 。delete() 方 法 的 第 一 个 参数 是 查询 条 件 ， 第 二 个 参数 是 一 个 处 理 错误 和 结果 的 回调 


函数 。 如 下 代码 可 以 删除 最 初 插入 的 jack 数据 。 


【示例 7-13】 
/* 引 入 模块 */ 
Var MongoClient = require('mongodb') .MongoClient; 
var Db = require('mongodb') .Db; 
Var server = require('mongodb') .Server; 
Var studentDb = new Db('student', new server('localhost', 


/* 打 开 数 据 库 */ 
studentDb .open (function (err，db) { 
ifl(err) { 
console.log('open err'); 
console.log (err); 
return; 
} 
/* 打 开 集 合 */ 
db.collection('student', functionl(err, collection) { 
/* 出 错 则 关闭 数据 库 */ 
ENGrE). + 
console.log('collection error'); 
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【代码 说 明 】 
运行 这 段 代码 ， 在 MongoDB 运行 正常 的 情况 下 ， 可 以 发 现 控制 台 打 印 出 了 “delete 
success” 字 样 。 利 用 控制 台 工具 查询 student 集合 下 的 所 有 文档 ， 同 样 可 以 发 现 jack 这 条 数据 
已 经 被 删除 。 
node-mongodb-native 模块 的 updateOne() 方 法 可 以 更 改 数据 , 与 查询 方法 类 似 。updateOne() 
方法 的 第 一 个 参数 是 查询 条 件 ， 第 二 个 参数 是 更 改 后 的 数据 ， 第 三 个 参数 是 一 个 处 理 错误 和 结 
果 的 回调 函数 。 如 下 代码 就 可 以 将 “ 张 三 ” 这 条 数据 的 名 字 改 为 “ 张 四 ”。 


【示例 7-14】 
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【代码 说 明 】 

运行 这 段 代 码 ， 在 MongoDB 运行 正常 的 情况 下 ， 可 以 发 现 控 制 台 打印 出 了 “update 
success ”字样 。 利 用 控制 台 工 具 查 询 student 集合 下 的 所 有 文档 ， 同 样 可 以 发 现 “ 张 三 ”这 条 
数据 的 名 字 已 经 被 改 为 “ 张 四 ”。 

以 上 知识 就 已 经 实现 了 使 用 node-mongodb-native 对 MongoDB 数据 库 进 行 简单 的 增删 查 
改 。 更 多 关于 node-mongodb-native 的 使 用 ,读者 可 以 通过 阅读 node-mongodb-native 的 官方 文 
档 进行 学 习 与 掌握 。 

这 里 需要 提出 的 是 ， 使 用 mongoose 会 相对 简单 一 点 ， 毕 竟 mongoose 是 基于 
node-mongodb-native 开发 的 。 如 果 读 者 对 其 感 兴趣 ， 可 以 学 习 一 下 node-mongodb-native， 对 
mongoose 的 使 用 是 有 很 大 帮助 的 。 另 外 ， 读 者 应 该 掌握 MongoDB 基本 的 增删 查 改 操 作 ， 以 
便 在 学 习 过 程 中 验证 数据 的 操作 是 否 成 功 。 


了 .了 连接 MysQL 


MySQL 作为 一 种 典型 的 关系 型 数据 库 在 互联 网 中 被 大 量 使 用 。 本 节 将 使 用 mysql 模块 进 
行 MySQL 数据 库 的 连接 。 


7.3.1 MySQL 介绍 


MySQL 数据 库 由 瑞典 MySQL AB 公司 开发 ， 目 前 属于 Oracle 公司 。MySQL 采用 双 授 权 
模式 ， 分 为 商业 版 和 社区 版 。MySQL 数据 库 凭借 其 体积 小 、 速 度 快 、 总 成 本 低 等 特点 被 广泛 
应 用 在 Web 开发 中 。 经 典 的 开源 软件 架构 LAMP 中 的 M 便 是 指 MySQL。 

MySQL 的 官方 网 站 是 http://www.mysqlcom/ 。 读 者 可 以 在 社区 版 下 载 网 址 
https://dev.mysql.com/downloads/mysql/ 中 选择 相应 系统 的 版 本 。 
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MySQL APT Repository 凡 


Download Packages, 


Ubuntu Uns 16.10 (il, 32bi DES Sundie 











图 7.12 MySQL 下 载 页 面 
这 里 以 Windows 版 本 为 例 ， 安 装 过 程 大 致 如 下 : 


(1) 将 下 载 的 MySQL 软件 按照 常规 软件 的 步骤 安装 即 可 。 需 要 提醒 的 是 ， 在 安装 过 程 
中 ， 可 以 设置 MySQL 服务 的 端口 ， 默 认为 3306， 如 图 7.13 所 示 。 


画 MySQL Installer - -9 匡 到 


MySQL Installer Type and Networking 
7 7 


MySQL Ser Server Configuration Type 


Choose the comect 
define how much 








:onfiguration type for this MySQL 5 
asources are assigned to the MySQI 


rinstallation This setting will 





Config Type | Development Machine v 
Connectivity 
Use the following controls to select how you would Iike to connect to this server 
Tcp/lp Port Number 3306 
Open Firewall port for network access 
口 Named pipe Pipe Name MYSQL 
口 shared Memory Memory Name = MYSQL 
Advanced Configuration 





Net> Cancel 











图 7.13 ”MySQL 设置 端口 
(2) 在 安装 过 程 中 可 以 设置 root 用 户 的 密码 、 添 加 用 户 ， 如 图 7.14 所 示 。 
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Accounts and Roles 


MySQL. Installer 


MySQl 1 


Root Account Password 
Enter the password for the root account Please remember to store this password in a secure 
place. 
MySQL Root Password: |d| 全 
Repeat Password: - 
Password minimum length 4 
MySQL User Accounts 


Create MySQL user accounts for your users and applications. Assign a role to the user that 
consists of 3 set of prileges 





Mysal Usemame Host UserRole ad User 





< Back ea Cancel 





图 7.14 添加 MySQL 用 户 并 设置 密码 
(3) 安装 完成 后 ， 可 以 在 控制 台 使 用 以 下 命令 来 启动 MySQL: 
net start mysq15.7 








在 这 里 mysql5.7 是 已 经 安装 的 带 有 版 本 号 的 MySQL 软件 名 。 











同样 ， 也 可 以 在 Windows 的 服务 中 找到 MySQL 服务 ， 然 后 进行 启动 、 停 止 操作 ， 
7.15 所 示 。 








远近 一 个 项 目 来 音 看 它 的 闫 述 , 名 称 撞 玉 状态 。 启动 类型 。 登录 为 
多 Microsoft (R) 诊断 中 心 标 .。 诊断 -- 手动 本 地 系统 
移 Microsoft Account Sign-i.。 支持 … 手动 ( 裔 发 .。 本 地 系统 
各 Microsoft isCSl Initiator .。 管理 .. 手动 本 地 系统 
如 Microsoft Office ClickTo.。 管理 .， 正 在 .。 生动 本 地 系统 
总 soft Passport 为 用 .… 手动 (下 发 .。 本 地 系统 
过 soft Passport Cont.. 管理 手动 ( 裔 发 .。 本 地 服务 
匠 Microsoft Software Shad.， 管 理 .. 手动 本 地 系统 
入 Microsoft Storage Space... Micr... 手动 网 阁 服务 
选 Microsofk Windows SMS 根据. 手动 (触发 .， 本 地 系统 
我 Mozilla Maintenance Ser-，Moz. 手动 本 地 系统 


她 MysQt57 


NetTcp Port Sharing Ser... 
过 Netogon 

池 Network Connected Devi... 
芝 Network Connection Bro.， 人 允许 .。 正 在.… 
有 RNetwork Connections 管理 正在 . 
迄 Network Connectivity Ass.. 提供 .… 














如 Network List Sevice 识别 .，。 正在 
敬 Network Location Aware..， 收集 正在 
Ba 9 [rE 于 = 











图 7.15 从 Windows 服务 中 启动 MySQL 
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如 图 


(4) 启动 MySQL 后 ， 通 过 以 下 命令 可 以 进入 MySQL: 


mysql -u root -p 


量 趣 | root 是 用 户 名 ，MySQL 自 带 root 用 户 ， 读 者 可 用 自己 的 用 户 名 进入 。 


(5) 输入 命令 后 ， 会 紧 接着 要 求 输入 密码 。 输 入 用 户 的 密码 后 ， 可 以 看 到 图 7.16 所 示 的 
界面 ， 表 示 成 功 进 入 了 MySQL。 








Type 'help;' or '\h' for help. '\c' rent input statement. 





图 7.16 进入 MySQL 


(6) 进入 MySQL 后 ， 可 以 通过 输入 “help” 或 者 “\h” 查 看 MySQL 命令 的 帮助 ， 如 图 
7.17 所 示 。 





图 7.17 MySQL 的 帮助 


(7) 当 我 们 不 需要 使 用 MySQL 时 ， 可 以 通过 quit 命令 退出 MySQL， 如 图 7.18 所 示 。 


quit 





图 7.18 退出 MySQL 





这 里 仅仅 是 对 MySQL 进行 简单 的 介绍 , 读者 可 以 通过 阅读 相关 的 书籍 
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7.3.2 ”Node.js 连接 MySQL 


Node.js 连接 MySQL 使 用 的 是 mysql 模块 mysql 模块 的 GitHub 地 址 是 https://github.com/ 
mysqljs/mysql， 从 中 可 以 阅读 到 官方 文档 。 使 用 这 个 模块 前 需要 通过 NPM 来 安装 : 


mysql 模块 通过 createConnection() 方 法 创建 MySQL 连接 。 如 下 代码 即 和 本 地 的 MySQL 
数据 库 建 立 了 连接 。 


【示例 7-15】 





【代码 说 明 】 
CreateConnection() 方 法 创建 连接 ，connection.connect() 方 法 判断 连接 是 否 成 功 。 
CreateConnection() 方 法 接受 一 个 json 对 象 参数 。json 对 象 主要 使 用 的 字段 有 : 


host: 需要 连接 数据 库 地 址 ， 默 认为 localhost。 
port: 连接 地 址 默认 的 端口 ， 默 认为 3306。 
user: 连接 MySQL 时 使 用 的 用 户 名 。 
password: 用 户 名 对 应 的 密码 。 

database: 所 需要 连接 的 数据 库 的 名 称 。 


通过 end() 方 法 可 以 正常 地 终止 一 个 连接 : 
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当然 ,使 用 destory0) 方 法 也 可 以 终止 连接 。 该 方法 会 立即 终止 底层 套 接 字 , 不 会 触发 更 多 
的 事件 和 回调 函数 。 


7.3.3 ”Node.js 操作 MySQL 


连接 MySQL 成 功 后 ， 就 需要 通过 Nodejs 来 操作 数据 库 了 。mysql 模块 提供 了 一 个 名 为 
query() 的 方法 ， 可 以 用 来 执行 SQL 语句 ， 从 而 对 MySQL 数据 库 进行 相应 的 操作 。 

假设 我 们 连接 的 数据 库 有 一 个 名 为 data 的 数据 表 ， 可 以 使 用 以 下 代码 将 这 个 data 数据 表 
的 所 有 记录 查询 出 来 。 


【示例 7-16】 
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运行 这 段 代 码 就 可 以 看 到 所 有 的 记录 被 打印 出 来 了 。 

上 述 代码 中 connection.query() 方 法 的 第 一 个 参数 是 一 条 SQL 语句 ， 第 二 个 参数 是 一 个 回 
调 函 数 。 回 调 函数 中 的 第 一 个 参数 是 err， 第 二 个 参数 是 执行 SQL 语句 后 返回 的 记录 。 

connection.query() 方 法 还 有 一 个 paramJnfo 参数 可 选 . 当 SQL 语句 中 含有 一 些 变量 的 时 候 ， 
可 以 将 “?” 作 为 占 位 符 放置 在 SQL 语句 中 ， 通 过 paramInfo 参数 传递 给 SQL 语句 。 


【示例 7-17】 








运行 这 段 代码 ， 同 样 可 以 从 mytable 数据 表 中 取出 所 有 的 数据 记录 。 

mysql 模块 还 提供 了 一 个 escape() 方 法 ,用 来 防止 SQL 注入 攻击 。SQL 注入 攻击 的 本 质 就 
是 黑客 在 提交 给 服务 器 的 数据 中 带 有 SQL 语句 ， 试 图 欺骗 服务 器 ， 让 服务 器 运行 自己 的 恶意 
SQL 语句 ， 因 此 使 用 escape 方法 处 理 用 户 提交 的 数据 可 以 防止 SQL 注入 攻击 。 
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假设 userid 为 用 户 提供 的 数据 ， 可 以 先 通过 connection.escape() 方 法 处 理 一 遍 ， 之 后 再 执 
行 相关 的 SQL 语句 。 


【示例 7-18】 





了 .处 ”实战 一 学 生成 绩 录入 系统 


本 节 将 利用 本 章 前 面 所 介绍 的 知识 实现 一 个 简单 的 实例 : 创建 一 个 简单 的 学 生成 绩 录 入 系 
统 ， 利 用 MySQL 数据 库 对 学 生成 绩 进行 保存 ， 同 时 利用 Nodejs 的 mysql 模块 对 这 个 数据 库 
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进行 读 取 。 前 台 主要 分 为 两 个 页 面 ,一 个 页 面 用 于 对 学 生成 绩 进 行 录入 ， 一 个 页 面 用 来 展示 所 
有 学 生成 绩 。 为 了 提高 开发 速度 ， 整 个 系统 采用 express 这 个 成 熟 的 Node.js 框架 。 


7.4.1 生成 基本 的 项 目 结构 
使 用 express 和 express 生成 器 之 前 需要 通过 NPM 安装 : 
npm install express express-generator -g 


安装 成 功 后 利用 express 的 生成 器 自动 生成 基本 的 项 目 结构 。 因 为 这 里 选择 使 用 sjs 模板 
引擎 ， 所 以 需要 加 -e 参数 ， 
express-estudent 


这 时 在 使 用 命令 的 目录 中 会 自动 生成 一 个 名 为 student 的 文件 夹 。 文 件 夹 的 目录 结构 如 图 
7.19 所 示 。 


JetBrains WebSt... 
JSON 文 件 





图 7.19 express 生成 器 生成 的 目录 结构 
在 这 个 目录 中 的 package.json 中 已 经 声明 了 相关 的 模块 ， 执 行 安装 即 可 : 
pm install 
为 了 使 用 mysql 这 个 模块 ， 同 样 需要 通过 NPM 安装 这 个 模块 : 
pm install mysql --save 
整个 项 目 使 用 的 是 ejs 模板 ， 同 样 需 要 通过 NPM 来 安装 这 个 模块 : 
pm install es 


7.4.2 ”数据库 设计 


作为 一 个 简单 的 成 绩 录 入 系统 ， 数 据 库 中 存在 的 仅仅 是 学 生成 绩 ， 很 容易 想到 这 里 要 使 
用 字段 学 号 、 学 生 姓 名 ， 并 假设 成 绩 只 有 三 个 科目 《语文 、 英 语 和 数学 ) 。 当 然 ， 这 些 字段 都 
不 能 为 室 。 这 样 可 以 很 容易 地 完成 数据 库 的 设计 ， 如 图 7.20 所 示 。 
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Chinese | Field Type Null Key Default Extra 

学 号 ID int NO PRI NULL autoincrement ， 
姓名 name varchar NO | UNI | NULL 

语文 chinese int NO 

英语 | english int NO 

数学 math int NO 


图 7.20 学 生成 绩 表 结 构 


得 到 表 结构 后 就 需要 在 MySQL 中 创建 响应 的 数据 库 与 数据 表 了 。 通过 命令 行 输入 下 面 的 
代码 ， 就 可 以 创建 相应 的 数据 库 和 数据 表 了 。 





至 此 ， 学 生成 绩 的 数据 库 和 数据 表 已 经 建立 。 


7.4.3 ”成 绩 录入 路 由 开发 


这 里 将 router 文件 夹 下 的 index 文件 作为 成 绩 录 入 的 路 由 。 这 个 路 由 的 功能 有 两 个 : 一 个 
是 显示 成 绩 录 入 的 页 面 ， 另 一 个 是 通过 这 个 路 由 来 保存 相应 的 学 生成 绩 数据 。 很 明显 ， 这 里 可 
以 根据 HTTP 方法 来 实现 ， 前 者 是 GET 方法 ， 后 者 是 POST 方法 。GET 方法 仅仅 是 获取 一 个 
页 面 。 

既然 需要 使 用 数据 库 ， 就 要 首先 与 数据 库 创 建 相应 的 连接 。 在 项 目 目录 中 新 建 一 个 名 为 
dbjs 的 文件 ， 并 根据 本 章 前 面 所 讲 的 相关 知识 建立 MySQL 数据 库 连 接 : 
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通过 模块 的 导出 将 使 得 这 个 数据 库 模 块 更 加 通用 。 
成 绩 录入 的 模块 GET 方法 依旧 使 用 express 自 定 义 的 模板 index， 并 将 router 文件 夹 下 的 
index.js 文件 改 为 以 下 代码 : 





POST 方法 的 功能 就 是 将 前 端 界 面 用 户 输入 的 数据 获取 下 来 ， 然 后 通过 SQL 语句 将 这 些 
数据 存 进 数据 库 中 。 前 端 传送 的 数据 是 存在 req.body 对 象 中 的 ， 可 以 利用 这 一 点 将 数据 获取 
下 来 , 结合 响应 的 SQL 语句 和 mysql 模块 的 query0 方 法 将 数据 保存 在 相应 的 数据 库 中 。POST 
方法 的 代码 如 下 : 
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这 样 成 绩 录 入 的 路 由 就 开发 完毕 了 。 


7.4.4 读 取 学 生成 绩 路 由 开发 

这 里 使 用 router 文件 夹 下 的 userjs 作为 路 由 。 很 明显 ， 这 个 路 由 只 需要 使 用 一 个 GET 方 
法 即 可 。 

简单 思路 就 是 用 户 获 取 这 个 页 面 之 后 ， 后 端 响应 对 MySQL 数据 库 进行 查询 ， 将 查询 得 到 


的 数据 传递 给 模板 引擎 处 理 ， 从 而 泻 染 出 完整 的 页 面 。 相 关 的 知识 前 文 已 经 介绍 ， 这 里 直接 给 
出 这 个 路 由 的 代码 。 





最 后 ， 利 用 命令 行 运行 app.js 文件 便 可 以 启动 项 目 了 。 整 个 前 台 页 面 如 图 7.21 和 图 7.22 
所 示 。 
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[= 
学 生成 绩 录 入 
姓名 
语文 
英语 
数学 
图 7.21 学 生成 绩 录 入 页 面 
学 生成 绩 查 询 
姓名 语文 英语 数学 
李 四 90 5 100 
王石 90 90 9 
赵 六 97 78 
孙 七 90 23 99 
王八 90 78 79 


图 7.22 学 生成 绩 查询 页 面 
当然 ， 实 现 这 样 一 个 页 面 需 要 读者 掌握 基本 的 HTML 和 CSS 知识 。 读 者 可 以 自行 通过 阅 


读 相应 的 书籍 进行 学 习 与 掌握 。 


了 .与 温 故 知 新 


学 完 本 章 ， 读 者 需要 回答 : 


1. 如 何 通 过 mongoose 连接 和 操作 MongoDB? 

2. 如 何 通过 node-mongodb-native 连接 和 操作 MongoDB? 
3. 如 何 通 过 mysql 模块 连接 和 操作 MySQL? 

4. 什么 是 SQL 注入? 

5. 如 何 使 用 express 生成 器 快速 生成 一 个 项 目 ? 

6. ejs 模板 引擎 的 基本 使 用 方法 是 什么 ? 


第 三 篇 
Node.js 实 踊 


本 篇 主要 介绍 Nodejs 在 实际 开发 中 的 运用 ， 主 要 包括 Node.js 的 Express、Meteor 框架 、 
Node.js 的 单元 测试 、Node.js 部 署 中 的 实际 运用 。 





目前 使 用 Node.js 技术 的 人 大 都 是 前 端 人 员 。 如 今 前 端 技术 发 展 迅 速 ， 了 解 当前 的 主流 前 
端 开发 技术 是 每 个 Web 开发 人 员 的 必修 课 。 
通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 
使 用 jQuery 快速 操作 DOML。 
了 解 React 的 使 用 和 基本 概念 。 
完成 一 个 简单 的 React 页 面 。 


前 端 框架 介绍 一 一 jQuery 


jQuery 是 一 个 快速 、 简 洁 的 JavaScript 框架 ， 是 继 Prototype 之 后 又 一 个 优秀 的 JavaScript 
代码 库 (或 JavaScript 框架 ) 。jQuery 设计 的 宗旨 是 “Write Less，Do More”， 即 倡导 “ 写 更 
少 的 代码 ， 做 更 多 的 事情 ”。 
8.1.1 jQuery 介绍 


jQuery 的 官方 网 站 ( 见 图 8.1) 是 https:Wiquery.cony GitHub 地 址 为 https://github.conyjquery/jquery 。 
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图 8.1 jQuery 官方 网 站 


jQuery 诞生 于 2007 年 ， 经 过 十 来 年 的 发 展 已 经 成 为 每 一 个 前 端 人 员 必 备 的 技能 。jQuery 
对 DOM 操作 的 封装 甚至 使 很 多 初 涉 前 端 这 个 领域 的 人 员 只 知 jQuery， 不 知 原生 JavaScript。 
在 前 端 这 个 日 新 月 异 的 领域 ，jQuery 在 十 来 年 中 依旧 能 够 受到 大 量 编程 人 员 的 追捧 ， 不 得 不 
说 这 是 一 个 奇迹 。 

jQuery 简化 了 开发 人 员 操 作 DOM、 处 理事 件 、 执 行动 画 和 开发 Ajax 的 操作 ， 同 时 这 些 
操作 对 浏览 器 都 是 兼容 的 。 这 种 简化 改变 了 前 端 编程 人 员 的 代码 设计 思路 和 编程 方式 , 同时 极 
大 地 提高 了 前 端 开 发 人 员 的 生产 力 。 

jQuery 的 主要 特点 有 : @ 轻 量 , 压缩 后 大 小 在 30KB 左右 ; @ 强 大 的 选择 器 ; @ 链 式 操作 ; 
四 优雅 的 动画 ;@@ 出 色 的 DOM 封装 ，@ 兼 容 主流 浏览 器 。 

获取 jQuery 的 方式 非常 简单 ， 可 以 从 jQuery 官方 网 站 中 选择 相应 的 版 本 进行 下 载 。 下 载 
之 后 可 以 选择 开发 版 或 者 生产 版 进行 使 用 。 只 需要 像 使 用 其 他 普通 的 JavaScript 脚本 一 样 ， 使 
用 script 标签 进行 引入 : 
<script type="text/javascript" src="scripts/jquery.js"></script> 

引入 之 后 就 可 以 尽情 使 用 jQuery 了 。 


8.1.2 使 用 jQuery 选择 器 


jQuery 中 的 选择 器 完全 继承 了 CSS 的 风格 。 这 样 就 可 以 非常 方便 地 使 用 jQuery 选择 器 快 
速 找 出 特定 的 DOM 元 素 ， 从 而 对 DOM 元 素 进 行 相应 的 操作 或 者 添加 相应 的 行为 。 得 益 于 
jQuery 的 浏览 器 兼容 性 处 理 , 使 用 这 些 jQuery 的 选择 器 完全 不 需要 担心 浏览 器 的 兼容 性 问题 。 
jQuery 选择 器 主要 可 以 分 为 以 下 几 类 。 
1. 基本 选择 器 
$("#id"): id 选择 器 ， 返 回 单个 元 素 。 
$(".class"): class 选择 器 ， 返 回 集合 元 素 。 
S$("element"): 选 定 指定 的 元 素 名 匹配 的 元 素 ， 返 回 集合 元 素 。 
$("*"): 通配符 选择 器 ， 选 择 所 有 元 素 ， 返 回 集合 元 素 。 
$("selectorl,selector2"): 选择 所 有 选择 器 匹配 的 元 素 ， 返 回 集合 元 素 。 
层次 选择 器 
$("ancestor descendant"): 选择 ancestor 元 素 的 所 有 descendant 后 代 元 素 ， 返 回 集合 元 素 。 
$("parent>child"): 选择 parent 下 的 child 子 元 素 。 
$("prev+tnext"): 选择 紧 接 在 prev 后 面 的 同辈 next 元 素 。 
$("prev~siblings"): 获取 prev 后 面 的 所 有 同辈 siblings 元 素 。 
其 中 ，S$("prev+next") 与 $("prev").next() 效 果 相 等 ，$("prev~siblings") 与 $("prev").sibling() 效 
果 相 等 。 
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基本 过 滤 选择 器 
:first: 选取 第 一 个 元 素 ， 返 回 单个 元 素 。 
:last: 选取 最 后 一 个 元 素 ， 返 回 单个 元 素 。 
:not(selector): 去 除 所 有 给 定 选择 器 所 匹配 的 元 素 ， 返 回 集合 元 素 。 
:even: 选取 索引 为 偶数 的 所 有 元 素 ， 索 引号 从 0 开始 ， 返 回 集合 元 素 。 
:odd: 选取 索引 为 奇数 的 所 有 元 素 ， 索 引号 从 0 开始， 返回 集合 元 素 。 
:ep(index): 选取 索引 等 于 index 的 元 素 ，index 从 0 开始 ， 返 回 单个 元 素 。 
:gt(index): 选取 索引 大 于 index 的 所 有 元 素 ， 返 回 集合 元 素 。 
:lt(index): 选取 索引 小 于 index 的 所 有 元 素 ， 返 回 集合 元 素 。 
:header: 选取 所 有 的 标题 元 素 ， 返 回 集合 元 素 。 
:animated: 选取 正在 执行 动画 的 元 素 ， 返 回 集合 元 素 。 
:focus: 选取 当前 获取 焦点 的 元 素 ， 返 回 集合 元 素 。 

内 容 过 滤 选 择 器 
:contains(texb: 选取 含有 文本 内 容 为 text 的 元 素 ， 返 回 集合 元 素 。 
:empty: 选取 没有 子 节点 或 者 文本 的 空 元 素 ， 返 回 集合 元 素 。 
:has(selector): 选取 含有 选择 器 所 匹配 的 元 素 的 元 素 ， 返 回 集合 元 素 。 
:parent: 选取 含有 子 节点 或 者 文本 的 元 素 ， 返 回 集合 元 素 。 

可 见 性 过 滤 选 择 器 
:hidden: 选取 所 有 不 可 见 的 元 素 ， 返 回 集合 元 素 。 
:visible: 选取 所 有 可 见 的 元 素 ， 返 回 集合 元 素 。 

属性 过 滤 选 择 器 
[attribute]: 选取 含有 此 属性 的 元 素 ， 返 回 集合 元 素 。 
:[attribute=value]: 选取 属性 的 值 为 value 的 元 素 ， 返 回 集合 元 素 。 
:[attribute!=value]: 选取 属性 的 值 不 为 value 的 元 素 ， 返 回 集合 元 素 。 
:[attribute^=value]: 选取 属性 的 值 以 value 开始 的 元 素 ， 返 回 集合 元 素 。 
:[attribute$=value]: 选取 属性 的 值 以 value 结尾 的 元 素 ， 返 回 集合 元 素 。 
:[attribute*=value]: 选取 属性 的 值 含有 value 的 元 素 ， 返 回 集合 元 素 。 
:[attribute|=value]: 选取 属性 的 值 等 于 value 或 者 是 以 value 为 前 级 ( 即 “value-”， 
value 后 面 跟 一 个 连 字 符 ) 的 元 素 ， 返 回 集合 元 素 。 
:[attribute~=value]: 选取 属性 的 值 以 空格 分 隔 的 值 中 含有 value 的 元 素 ， 返 回 集合 元 
素 : 
:[attributel][attribute1]… …[attributeN1]: 用 多 个 属性 选择 器 合并 成 一 个 复合 属性 选择 
器 ， 返 回 集合 元 素 。 
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子 元 素 过 滤 选 择 器 

:nth-child(index/even/odd): 选取 父 元 素 下 的 第 index 个 子 元 素 ，index 值 从 1 开始 , 或 
者 选取 奇 、 偶 子 元 素 ， 返 回 集合 元 素 。 

:first-child: 选取 父 元 素 下 的 第 一 个 子 元 素 ， 返 回 集合 元 素 。 

:last-child: 选取 父 元 素 下 的 最 后 一 个 子 元 素 ， 返 回 集合 元 素 。 

:only-child: 如 果 元 素 是 父 元 素 的 唯一 元 素 就 选择 ， 否 则 不 选择 ， 返 回 集合 元 素 。 


另外 ，:nth-child() 还 可 以 通过 数学 表达 式 选取 一 组 特定 的 元 素 ， 如 :nth-child(3n) 就 选取 父 


元 素 下 所 有 3 的 倍数 的 子 元 素 (z 从 1 开始 ， 即 选取 第 3、6、9……… 个 元 素 ) 。 
8. 表单 选择 器 
@ :input: 选取 所 有 的 input、textarea、select、button 元 素 ， 返 回 集合 元 素 。 
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8.1.3 


:text: 选取 所 有 的 单行 文本 框 ， 返 回 集合 元 素 。 
:password: 选取 所 有 的 密码 框 ， 返 回 集合 元 素 。 
:radio: 选取 所 有 的 单 选 框 ， 返 回 集合 元 素 。 
:checkbox: 选取 所 有 的 多 选 框 ， 返 回 集合 元 素 。 
:submit: 选取 所 有 的 提交 按钮 ， 返 回 集合 元 素 。 
:image: 选取 所 有 的 图 像 按 钮 ， 返 回 集合 元 素 。 
:reset: 选取 所 有 的 重 置 按钮 ， 返 回 集合 元 素 。 
:button: 选取 所 有 的 按钮 ， 返 回 集合 元 素 。 
:file: 选取 所 有 的 上 传 域 ， 返 回 集合 元 素 。 
表单 对 象 属性 过 滤 选 择 器 
:enabled: 选取 所 有 可 用 元 素 ， 返 回 集合 元 素 。 
:disabled: 选取 所 有 不 可 用 元 素 ， 返 回 集合 元 素 。 
:checked: 选取 所 有 被 选中 的 元 素 ( 单 选 框 和 多 选 框 ) ， 返 回 集合 元 素 。 
:selected: 选取 所 有 被 选中 的 元 素 ( 下 拉 列 表 ) ， 返 回 集合 元 素 。 


使 用 jQuery 进行 DOM 操作 


原生 JavaScript 对 于 DOM 的 操作 非常 复杂 ， 而 且 各 大 浏览 器 对 于 DOM 的 实现 标准 也 不 
一 样 ， 因 此 造成 原生 JavaScript 在 DOM 操作 方面 如 同 鸡 肋 一 般 ， 不 过 jQuery 为 我 们 提供 了 大 
量 简洁 的 DOM 操作 方法 。 
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查找 和 设置 相应 属性 的 方法 
attr() 方 法 : 接收 一 个 或 两 个 参数 ( 一 个 参数 时 用 于 获取 属性 值 ， 两 个 参数 时 用 于 设置 
属性 )。 需 要 设置 多 个 属性 时 , attr 方法 的 参数 可 以 是 一 个 由 属性 和 属性 值 组 成 的 json 
数据 格式 。 
css() 方 法 : 接收 一 个 或 两 个 参数 ( 当 一 个 参数 是 属性 名 时 ， 获 取 属 性 值 ， 当 接收 两 个 


Var 
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参数 时 ， 设 置 属性 第 一 个 参数 为 属性 名 ， 第 二 个 参数 为 属性 值 ) 。 需 要 设置 多 个 属性 
时 ，css 方法 的 参数 可 以 是 一 个 由 属性 和 属性 值 组 成 的 json 数据 格式 。 

addClass(): 为 元 素 添加 class 值 ， 可 批量 添加 属性 与 值 。 

TemoveAttr(0): 删除 指定 的 属性 。 

removeClass(): 有 参数 时 ， 删 除 指定 的 class 值 ; 没有 参数 时 ， 删 除 全 部 的 class 值 。 
hasClass(): 判断 匹配 的 元 素 是 否 有 某 个 class 值 ， 有 就 返回 true， 没 有 则 返回 false。 


. 创建 元 素 、 文 本 、 属 性 节点 的 方法 


可 以 直接 将 元 素 、 文 本 、 属 性 添加 到 $0 方法 中 ， 例 如 : 
p=$ ("<p title='mytitle'> 假 装 是 标题 </p>" 


3. 
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插入 节点 的 方法 
append(): 向 元 素 内 部 添加 节点 。 
appendTo(): 将 元 素 添加 到 指定 元 素 内 部 ， 即 将 append 方法 中 的 链 式 操作 成 员 互 换 
位 置 。 
prepend(): 向 元 素 内 部 前 置 内 容 。 
prependTo(): 将 节点 前 置 到 指定 元 素 中 ， 即 将 prepend 方法 链 式 操作 中 的 成 员 互 换 位 
要。 
after(): 在 每 个 元 素 节点 后 添加 节点 。 
insertAfter(): 将 节点 插入 到 指定 节点 之 后 ， 即 将 after 方法 链 式 操作 中 的 成 员 互 换 位 
年。 
before(): 在 节点 前 面 插入 节点 。 
insertBefore(): 将 节点 插入 到 指定 元 素 前 面 。 


删除 节点 的 方法 


remove(0: 从 DOM 中 删除 所 有 匹配 的 元 素 ， 同 时 该 节点 所 包含 的 所 有 后 代 节 点 将 同 
时 被 删除 ， 因 为 返回 值 是 删除 节点 的 引用 ， 所 以 可 以 在 以 后 继续 使 用 这 些 元 素 , 但 是 
这 些 节 点 所 绑 定 的 事件 也 会 删除 。 

detach(): 和 remove() 几 乎 一 样 ， 不 同 的 是 detach 方法 不 会 删除 节点 所 绑 定 的 事件 和 
附加 的 数据 。 

empty0: 清空 所 匹配 的 节点 。 


复制 节点 的 方法 
clone(): 复制 节点 ， 可 以 有 true 参数 。 当 有 true 参数 时 ， 将 同时 复制 节点 所 绑 定 的 事件 。 
茶 换 节点 的 方法 


replaceWith(): 将 匹配 的 节点 替换 成 指定 的 节点 。 
replaceAll0: 用 指定 的 节点 替换 相应 节点 ， 即 将 replaceWith 方法 链 式 操作 中 的 成 员 
互 换 位 置 。 


141 





Node.js 开发 实战 


7. 遍历 节点 


@ children(): 获取 所 有 的 子 元 素 集合 ， 返 回 一 个 数组 ， 只 考虑 子 元 素 ， 不 考虑 其 他 后 代 
元 素 。 
next(): 获取 匹配 元 素 后 面 紧 邻 的 同辈 元 素 ， 效 果 类 似 于 $("prev+tnext")。 
prev(): 获取 匹配 元 素 前 面 紧 邻 的 同辈 元 素 。 
siblings(): 获取 匹配 元 素 前 后 所 有 的 同辈 元 素 ， 类 似 于 $("prev~siblings")。 
closest(: 获取 最 近 的 符合 匹配 的 一 个 父 元 素 。 
parent(): 获取 一 个 父 元 素 。 
parents(): 获取 所 有 匹配 的 一 个 祖先 元 素 。 
事件 与 动画 


加 载 DOM 使 用 $(document).ready(): 和 原生 的 JavaScript 的 window.onload() 方 法 有 类 
似 的 功能 。window.onload() 方 法 是 在 网 页 中 所 有 的 元 素 ( 包括 元 素 的 所 有 关联 文件 ) 
完全 加 载 到 浏览 器 后 才 执行 ; $(document).ready0) 在 DOM 完全 就 绪 时 就 可 以 被 调用 ， 
此 时 并 不 意味 着 这 些 关联 文件 都 已 经 下 载 完 毕 。 另 外 ，$(document).ready() 可 多 次 使 
用 ; 而 window.onload() 只 能 用 一 次 ， 多 次 使 用 时 会 出 现 覆 盖 的 现象 。 除 此 之 外 ， 
$(document).ready 可 以 简写 成 $().ready()。 

@ 事件 绑 定 使 用 bind(): 可 以 有 三 个 参数 ， 第 一 个 参数 是 事件 类 型 ， 第 二 个 参数 可 选 ， 
作为 event.data 属性 值 传 给 事件 对 象 的 额外 数据 对 象 ， 第 三 个 参数 是 处 理 函 数 。 
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常见 的 事件 类 型 有 blur、focus、load 、resize、scroll、unload 、click、dbclick 、mousedown、 
mouseup、 mouseover、 mousemove、 mouseout、 mouseenter、 mouseleave、 change、 select、 submit、 
keydown、keyup、error。 其 中 ，click、mouseover、mouseout 这 类 常用 的 事件 可 以 简写 : 





9. 合成 事件 

jQuery 中 有 两 个 合成 事件 一 hover0 和 toggle() 方 法 。 

@ 。 hover(): 用 于 模拟 光标 悬 停 事 件 。 语 法 : 
hover(enter'leave 

当 光 标 移动 到 元 素 时 会 触发 第 一 个 函数 ， 离 开 时 触发 第 二 个 函数 。 

@ toggle0: 用 于 模拟 鼠标 连续 点 击 事件 。 语 法 : 


第 8 章 前 端 框架 


toggle (fn1, fn2,....., En) 7 


前 端 框架 介绍 一 React 


React 起 源 于 Facebook 的 内 部 项 目 。React 的 出 现 是 革命 性 的 创新 ， 它 的 横 空 出 世 使 全 球 

的 JavaScript 开发 者 为 之 疯狂 , 可 以 说 React 是 一 个 颠覆 式 的 前 端 框架 .React 官方 这 样 介绍 它 ; 

个 声明 式 、 高 效 、 灵 活 的 、 创 建 用 户 界面 的 JavaScript 库 。 虽 然 React 的 主要 作用 是 构建 UI， 
但 是 项 目的 逐渐 成 长 已 经 使 得 React 成 为 前 后 端 通 吃 的 Web App 解决 方案 。 


8.2.1 React 介绍 


React 的 官方 网 址 为 https://facebook.github.io/react/( 见 图 8.2),， GitHub 地 址 为 https://github.com/ 
facebook/react。 


React 


A JAVASCRIPT LIBRARY FOR BUILDING USER INTERFACES 


Get Started Take the Tutorial 





Declarative Component-Based Learn Once, 

Roact makos it painloss to croato Build oncapsulatod compononts that Write Anywhere 

interactive Uls. Design simple views for manage their own state, then compose i 
each state in your application, and them to make complex UIs. 


rest of your technology stack, so you 
React will efficiently update and render sd 


Te Since component logic is written in can develop new features in React 
i a 要 JavaScript instead of templates, you without rewriting existing code. 
SO NAY pnt He Hn Nirongti yat Roact can also rondor on tho server 
Declarative views make your code app and keep state out of the DOM 


using Node and power mobile apps 


more predictable and easier to debug. RE 





图 8.2 React 官方 网 站 


React 的 声明 式 特点 减少 了 操作 DOM 的 性 能 损耗 ， 同 时 利用 项 目的 解 耦 以 及 项 目 人 员 的 
相互 配合 以 及 同时 组 件 化 开发 思想 使 得 大 量 组 件 得 以 复 用 。React 内 部 实现 的 虚拟 DOM 和 
DOM diff 算法 使 DOM 的 操作 变 得 高 效 。 我 们 知道 在 JavaScript 中 一 个 DOM 节点 有 很 多 的 属 
性 和 方法 ， 在 开发 者 工具 中 ， 可 以 使 用 for...in 语句 打印 出 这 些 属性 和 方法 ， 如 图 8.3 所 示 。 
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图 83 DOM 节点 属性 和 方法 

-个 DOM 和 一 个 JavaScript 的 对 象 非常 像 ， 包 含 tagName、 属 性 、 子 节点 等 。 因 此 ， 可 
以 用 JavaScript 对 象 来 表示 DOM 节点 。 虚拟 DOM 就 是 这 个 思路 ,最 后 根据 DOM diff 算法 得 
出 变化 的 DOM， 最 后 应 用 于 真实 的 DOM， 从 而 尽 可 能 减少 DOM 操作 的 开销 。 

React 只 是 专注 于 UI 的 构建 ， 因 此 构建 大 型 应 用 还 需要 配合 其 他 技术 栈 一 起 使 用 ， 这 也 
下 是 React 的 灵活 性 体现 。 
) 为 了 减少 React 应 用 开发 环境 搭建 的 烦琐 ,可 以 使 用 Facebook 官方 推出 的 
create-react-app 脚手架 工具 。 使 用 create-react-app， 需 要 使 用 Node.js 在 全 局 安装 这 个 脚手架 ， 
代码 如 下 : 


npm install create-react-app -9 





~ 





(2) 安装 完成 后 就 可 以 使 用 create-react-app 这 个 工具 来 初始 化 一 个 React 项 目 了 。 可 以 
使 用 以 下 命令 初始 化 一 个 项 目 : 


create-react-app projectname 


(3) 命令 运行 完成 后 的 界面 如 图 8.4 所 示 。 








图 8.4 初始 化 界面 
(4) 根据 提示 的 运行 命令 , 进入 项 目 目录 后 , 使 用 npm start 命令 可 以 开始 运行 这 个 项 目 。 
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后 ， 可 以 在 浏览 器 中 输入 localhost:3000 地 址 ， 从 而 看 到 这 个 项 目 初始 化 的 样子 ， 如 图 8.5 


Welcome to React 


让 半 


运 
所 





To get started, edit src/App. js and save to reload. 





图 8.5 React 欢迎 界面 
(5) 进入 项 目 目录 后 可 以 看 到 这 个 create-react-app 创建 的 文件 和 文件 夹 ， 如 图 8.6 所 示 。 





node_modules 
public 

src 

.gitignore 
packagejson 
README.md 





图 8.6 ”craete-react-app 初始 化 目录 


其 中 需要 重点 关注 的 是 src 文件 夹 。 这 个 文件 夹 是 开发 的 文件 夹 ， 所 有 的 React 组 件 都 应 
该 存放 在 这 个 文件 夹 中 。src 文件 夹 的 文件 目录 如 图 8.7 所 示 。 








加 App.css 
国 Appjs 

园 Appitestjs 
园 index.css 
园 indexjs 
S| logo.svg 





园 registerServiceWorkerjs 








图 8.7 src 目录 


在 src 目录 中 ，index.js 是 整个 项 目的 入 口 文件 ， 定 义 了 
文件 对 应 的 DOM 节点 ， 文 件 内 容 如 下 : 


import React from 'react'; 





的 public 文件 夹 下 index.html 


import ReactDOM from 'react-dom'; 
import App from './App'; 
import registerServiceWorker from './registerServiceWorker'; 


import './index.css'; 


145 


Node.js 开发 实战 】 


(有 间 。 利用 create react-app 这 个 脚手架 工具 使 开发 React 应 用 免 去 了 开发 环境 指 建 的 烦琐 ， 只 需 | 
要 在 src 进行 开发 就 好 了 。create-react-app 也 提供 了 npm run build 命令 来 生成 生产 环境 文 | 
件 。 这 个 命令 会 将 所 有 的 js 文件 打包 压缩 为 一 个 js 文件， 用 于 生产 环境 。 








8.2.2 ”React 的 JSX 语言 


在 传统 的 Web 开发 中 ， 推 尝 HTML 与 JavaScript 文件 分 离 。Facebook 却 认为 组 件 才 是 
Web 开发 中 最 重要 的 。 为 了 将 HTML 文件 可 以 嵌入 在 JavaScript 代码 中 ，Facebook 拓展 了 
JavaScript 这 门 语言 ， 形 成 了 JSX 语言 。 

可 以 在 JavaScript 文件 中 正常 写 入 HTML 代码 。 在 上 一 小 节 中 生成 的 React 项 目 src 文件 
夹 下 的 APP.js 文件 内 容 如 下 : 





在 这 个 文件 中 ，render() 方 法 可 以 像 在 HTML 文件 中 书写 HTML 代码 ， 这 便 是 JSX 语言 。 
当然 JSX 语言 并 不 是 开发 React 所 必需 的 。 不 使 用 JSX， 可 以 使 用 React.createElement() 方 法 
来 创建 HTML 节点 ， 不 过 这 个 方法 远 没 有 JSX 语言 简明 易 读 ， 因 此 开发 中 强烈 建议 使 用 JSX 
语言 。 
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使 用 JSX 需要 注意 的 是 ，class 为 JavaScript 这 门 语 言 的 保留 字 , 应 该 使 用 className 来 代 
替 ， 同 时 HTML 的 for 属性 也 是 JavaScript 的 保留 字 ， 应 该 使 用 htmlFor 来 代替 。 

在 JSX 语言 中 ， 可 以 像 HTML 文件 一 样 正常 书写 HTML 标签 。 如 果 需 要 在 一 段 HTML 
标签 中 使 用 JavaScript 语言 就 需要 使 用 大 括号 {} 来 包围 JavaScript 代码 ， 告 诉 编译 工具 这 些 是 
JavaScript 代码 ， 具 体 如 下 : 


值得 注意 的 是 ,JSX 中 style 属性 应 该 作为 一 个 对 象 ， 因 为 对 象 是 JavaScript 的 语法 ,所 以 
又 应 该 需要 大 括号 包围 。 同 时 ，css 属性 也 不 再 是 使 用 中 划 线 连接 ， 而 是 使 用 驼峰 形式 ， 因 此 
声明 一 个 元 素 的 style 可 能 如 下 : 


在 实际 开发 中 , 一 段 列表 (如 文章 列表 ) 是 非常 常见 的 。 得 益 于 JSX 语言 , 利用 JavaScript 
的 循环 迭代 可 以 迅速 生成 一 段 列 表 ， 而 不 再 是 一 大 段 一 大 段 类 似 的 列表 元 素 。 在 JSX 中 可 以 
使 用 数组 来 存储 一 组 元 素 , 最 后 利用 大 括号 展开 即 可 。 例如 , 实现 一 段 简单 的 列表 , 修改 Appjs 
文件 如 下 : 





147 


Node.js 开发 实战 】 


export default ap 
在 浏览 器 中 可 以 看 到 一 段 列 表 顺 利生 成 了 ， 如 图 8.8 所 示 。 


react 
javascript 





8.8 快速 生成 列表 


给 如 此 生成 的 元 素 应 该 始终 带 有 key 属性 。 这 个 属性 是 React 为 了 标明 不 同 元 素 ， 从 而 用 来 | 
判断 哪个 元 素 变化 以 重新 泻 染 用 的 。 





8.2.3 React 的 props 和 state 


React 为 构建 UI 同时 提供 了 props 和 state 作为 数据 的 传递 使 用 。props 和 state 都 可 以 用 来 
表示 组 件 的 状态 , 而 props 是 作为 父 组 件 传 递 给 子 组 件 的 数据 , 所 以 这 就 可 以 形成 一 个 数据 流 ， 
而 state 是 作为 组 件 内 部 使 用 的 数据 或 者 状态 。 下 面 通过 实例 说 明 这 两 者 的 区 别 。 

在 src 目录 下 新 建 一 个 名 为 NameListjs 的 文件 ， 作 为 App.js 组 件 的 子 组 件 ， 写 入 以 下 内 
容 : 
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同时 将 App.js 修改 为 以 下 代码 : 








在 这 段 代码 中 , 子 组 件 的 username 和 age 都 是 props 数据 的 一 部 分 , 而 这 些 数据 都 是 由 父 
组 件 传递 过 来 的 ， 这 些 数 据 是 子 组 件 的 初始 化 数据 ， 不 能 修改 ; state 数据 是 由 子 组 件 自己 来 
维护 的 ， 同 时 子 组 件 可 以 修改 state 来 改变 组 件 自身 的 状态 ， 所 以 说 state 是 组 件 私有 的 数据 。 

利用 create-react-app 的 npm start 命令 可 以 启动 应 用 后 在 浏览 器 中 看 到 如 图 8.9 所 示 的 画 
面 ， 单 击 按钮 子 组 件 将 在 页 面 中 消失 。 


8.9 props 和 state 的 区 别 


利用 上 一 节 中 提 到 的 map 方法 可 以 很 轻松 地 复 用 这 个 组 件 ， 一 个 简单 的 列表 就 这 样 生成 
了 。 将 Appjs 文件 修改 为 以 下 代码 : 
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这 样 在 浏览 器 中 就 可 以 看 到 一 个 简单 的 列表 ， 如 图 8.10 所 示 。 








图 8.10 简单 的 列表 


因为 props 是 由 父 组 件 传递 给 子 组 件 的 ， 所 以 props 的 改变 只 能 寄 希 望 于 父 组 件 传递 新 的 


props。 而 state 是 组 件 自己 负责 维护 和 更 新 的 ， 因 此 React 提供 了 setState0 这 个 方法 来 更 
新 组 件 的 state。 需 要 注意 的 是 这 个 方法 是 异步 的 。 





8.2.4 ”React 的 组 件 生命 周期 


React 组 件 的 state 或 者 是 props 发 生 改 变 后 会 导致 这 个 组 件 重新 进行 泻 染 ， 此 时 DOM 也 
会 有 相应 的 变化 。 其 中 ， 只 有 Render 方法 是 上 文 提 到 的 ， 就 是 DOM 泻 染 时 的 方法 。 然 而 ， 
只 有 这 个 方法 是 不 够 的 , 因为 在 实际 开发 中 , 开发 者 往往 需要 在 泻 染 前 或 者 泻 染 后 去 做 一 些 额 
外 的 事情 ， 比 如 数据 的 请 求 、state 的 改变 等 。 因 此 开发 者 们 需要 对 组 件 的 各 个 阶段 进行 控制 ， 
这 样 就 可 以 足够 高 效 地 进行 开发 了 。 为 此 ，React 的 团队 提出 了 组 件 生命 周期 的 概念 。 

对 于 一 个 基本 的 React 组 件 , 可 以 将 每 个 React 组 件 的 生命 周期 分 为 初始 化 、 挂 载 、 更 新 、 
务 载 四 个 阶段 。React 为 这 四 个 阶段 提供 了 不 同 的 方法 ， 以 便 开 发 者 们 有 足够 控制 权 对 组 件 进 
行 控制 。 

React 的 组 件 生命 周期 可 以 用 图 8.11 进行 表示 。 
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图 8.11 组 件 生命 周期 


@ ”组 件 初始 化 阶段 的 方法 有 getDefaultProps()、getInitialState()。 

@ ”组 件 挂 载 阶段 的 方法 有 componentWillMount()、render()、componentDidMount()。 

@ 组 件 更 新 阶段 的 方法 有 shouComponentUpdate() 、componentWillUpdate 、render()、 
componentDidUpdate()、componentWillReceiveProps()。 

@ 组件 卸载 的 方法 有 componentWillUnmount()。 








属 元 在 组 件 挂 载 阶段 并 不 会 调用 组 件 更 新 阶段 的 这 些 方法 ， 也 就 是 说 在 初次 这 染 过 程 中 更 新 阶 
自 的 方法 是 不 可 用 ， 因 此 开发 者 们 不 应 该 将 处 于 初次 演 染 就 使 用 的 方法 在 更 新 阶段 来 使 
| ， 这 是 非常 不 明智 的 做 法 。 








同时 , shouldComponentUpdate() 方 法 应 该 返回 一 个 布尔 值 ， 如 果 返 回 值 为 true 就 继续 更 新 
这 个 组 件 ; 相反 ， 如 果 返 回 值 为 false， 这 个 组 件 将 不 更 新 。 也 就 是 说 ， 此 时 
componentWillUpdate()、render()、componentDidUpdate() 方 法 是 不 会 被 调用 的 。 

为 了 更 好 地 理解 组 件 生命 周期 的 概念 ， 利 用 一 段 代 码 或 许 更 好 说 明 。 将 App:js 文件 内 容 
修改 为 以 下 代码 : 
/* 引 入 React*/ 
import React, { Component } from 'react'; 


/* 引 入 样式 文件 */ 


import './App.css'; 





/* 构 建 类 */ 
class App extends Component { 
constructor() { 
super (); 
/* 定 义 初始 化 state*/ 
this.state = {name:1234} 
} 
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启动 这 个 应 用 后 ， 打 开 浏 览 器 的 控制 台 ， 可 以 看 到 图 8.12 所 示 的 画面 。 





Node.js 开发 实战 


willMount 


render 





didmount 





8.12 组 件 生 命 周 期 


这 与 预想 中 的 一 样 ， 处 于 组 件 更 新 阶段 的 方法 都 没有 被 调用 。 单 击 按钮 后 ， 组 件 的 state 
改变 了 ， 因 此 会 造成 这 个 组 件 的 重新 泻 染 ， 此 时 更 新 阶段 的 方法 的 执行 顺序 和 预期 一 致 ， 如 图 
8.13 所 示 。 


willMount 
render 
didmount 
shouldupdate 


willupdate 


render 
didupdate 





8.13 组 件 生 命 周 期 


如 果 将 处 于 更 新 阶段 的 shouldComponentUpdate() 的 返回 值 修改 为 false， 就 可 以 看 到 组 件 
并 没有 更 新 ， 处 于 这 个 方法 后 面 的 方法 也 就 自然 没有 被 调用 了 。 

作为 开发 者 ， 需 要 注意 的 是 这 些 处 于 生命 周期 的 函数 为 开发 者 更 好 地 控制 组 件 提供 了 可 
能 ， 同 时 也 应 该 善 用 这 些 方法 ， 因 为 对 这 些 方法 的 使 用 不 当 很 可 能 会 造成 React 应 用 的 性 
能 问题 。 


只 .了 实战 一 图 书信 息 统计 


本 节 将 利用 本 章 所 介绍 的 知识 实现 一 个 简单 的 React 实例 : 创建 一 个 简单 的 信息 统计 展示 
页 面 。 这 里 将 利用 笔者 个 人 作品 的 API 展示 一 个 简单 的 图 书 系统 信息 统计 页 面 。 这 个 页 面 展 
示 各 个 统计 信息 ， 同 时 实现 信息 统计 条 件 的 切换 。 


8.3.1 生成 基本 的 目录 结构 


这 里 使 用 脚手架 工具 create-react-app 进行 开发 。 使 用 create-react-app 脚手架 之 前 需要 使 用 
NPM 进行 安装 : 

















npm install create-react-app -9 


安装 完成 脚手架 工具 之 后 就 可 以 使 用 create-react-app 来 生成 项 目 目 录 结 构 了 。 
create-react-app 命令 如 下 : 
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等 待 一 段 时 间 后 就 可 以 看 到 生成 的 项 目 目录 结构 了 。 
在 生成 的 目录 结构 下 的 src 文件 夹 下 创建 component、container 和 utils 文件 夹 。 


8.3.2 ”基本 的 结构 开发 


一 个 结构 完整 的 网 站 一 般 包 括 header、banner、nav、footer 等 部 分 。 为 了 页 面 的 完整 ， 这 
些 结构 在 这 里 依旧 需要 。 在 container 文件 夹 下 分 别 创建 AsideContainer.js、BannerContainer.js、 
FooterContainerjs、HeaderContainerjs、MainContainerjs 文件 ， 如 图 8.14 所 示 。 


园 AsideContainerjs JetBrains WebsSt... 
园 BannerContainerjs JetBrains WebSt.… 


园 FooterContainerjs JetBrains WebSt... 
园 HeaderContainerjs JetBrains WebSt... 
园 MainContainerjs JetBrains WebSt... 














图 8.14 项 目 基本 目录 结构 
在 HeaderContainer.js 文件 中 写 入 以 下 内 容 : 





同 理 ， 在 BannerContainer.js 文件 夹 中 写 入 以 下 内 容 作 为 标识 : 
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Node.js 开发 实战 六 


其 他 几 个 组 件 也 一 样 。 其 中 ，MainContainerjs 文件 将 作为 开发 的 主要 文件 。 在 
MainContainerjs 文件 中 写 入 以 下 内 容 : 


在 component 中 创建 BarEchartjs、Echartjs、MainRigth.js、PieEchartjs 文件 作为 主要 开发 
的 组 件 文件 。 在 utils 文件 夹 中 创建 ajax.js 和 htime.js 文件 ， 分 别 用 来 作为 处 理 ajax 请 求 和 处 
理 时 间 的 函数 。 在 ajax.js 文件 中 写 入 以 下 内 容 : 
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在 htimejs 文件 中 写 入 以 下 内 容 : 





8.3.3 ”信息 图 表 的 开发 


为 了 简化 开发 、 提 高 开发 效率 ， 这 里 将 使 用 echart 这 个 图 表 库 ，echart 并 不 能 直接 用 在 
React 项 目 中 ， 对 应 的 有 一 个 rc-echarts 库 。 使 用 NPM 安装 这 个 库 之 后 就 可 以 像 使 用 echart 一 
样 使 用 这 个 库 了 。 


在 上 一 小 节 中 提 到 components 文件 夹 中 的 几 个 文件 。 其中，MainRightjs 是 其 他 组 件 的 入 
口 组 件 ， 因 此 开发 也 是 从 这 个 组 件 开始 的 ， 在 这 个 文件 中 写 入 以 下 内 容 : 
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Node.js 开发 实战 





第 8 章 ”前端 框 架 





这 里 需要 说 明 的 是 需要 将 ajax 请 求 置 于 componentDidMount 中 ， 同 时 BarEchartjs 和 
PieEchartjs 分 别 为 柱状 图 和 饼 状 图 的 组 件 ， 只 需要 按照 echart 的 配置 即 可 。 以 BarEchartjs 为 
例 ， 写 入 以 下 内 容 即 可 : 





Node.js 开发 实 








前 端 框架 





稍微 添加 一 些 样式 即 可 实现 漂亮 且 简 单 的 图 表 类 型 切换 和 时 间 切 换 的 功能 ， 如 图 8.15 和 
8.16 所 示 。 


qos 





图 8.15 项 目 饼 状 图 





8.16 项 目 条 形 图 
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轴 .4。 温 故 知 新 


学 完 本 章 ， 读 者 需要 回答 : 


1.jQuery 主要 解决 了 哪些 问题 ? 
2. React 的 生命 周期 概念 有 哪些 ? 
3. 什么 是 JSX， 使 用 JSX 需要 注意 哪些 问题 ? 


第 9 章 
< Node .js 的 框架 介绍 > 


随 着 Node.js 的 快速 发 展 和 普及 ， 基 于 Node.js 的 框架 也 如 雨后春笋 般 涌 现 出 来 。 其 中 有 
很 多 Node.js 框架 ， 可 以 帮助 你 快速 构建 实时 的 端 到 端 网 络 应 用 ， 并 且 无 须 任何 其 他 第 三 方 
Web 服务 器 、 应 用 服务 器 等 工具 和 技术 。 本 章 对 Node.js 的 主流 框架 进行 整体 介绍 ， 并 对 现在 
应 用 广泛 的 Express 和 Meteor 等 框架 进行 详细 的 分 析 和 比较 。 





通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 

@ ”Node.js 主流 框架 的 分 类 和 特点 。 

@ ”Express 框架 介绍 。 

@ ”Meteor 框架 介绍 。 

@ 其 他 一 些 流行 的 Nodejs 框架 介绍 。 
@ ”框架 的 选择 和 注意 事项 。 


Node.js 框架 整体 介绍 


Node.js 得 益 于 JavaScript 的 广泛 普及 而 在 短 时 间 内 飞速 发 展 , 让 前 端 开发 程序 员 仅仅 使 用 
JavaScript 就 可 以 建立 大 规模 、 实 时 性 、 可 扩展 的 移动 和 Web 应 用 程序 。 随 着 节点 生态 系统 的 
增长 ， 基 于 Node.js 的 框架 也 开始 稳步 发 展 。 对 于 一 个 中 小 型 的 开发 团队 来 说 ， 选 择 一 个 合 i 
的 框架 可 以 加 快 程序 的 开发 ， 使 得 应 用 更 加 健壮 并 减少 出 错 的 概率 。 

Node.js 的 分 类 有 很 多 方式 。 依 据 nodeframework 网 站 (http:/nodeframework.com/) 的 标 
准 ，Nodejs 的 框架 基本 可 以 分 为 四 大 类 : MVC 框架 、 全 栈 框架 、REST API 框架 以 及 其 他 框 
架 。 目 前 主流 的 Nodejs 框架 为 MVC 框架 和 全 栈 框架 。 下 面 将 分 别 介绍 这 几 大 类 框架 的 具体 
特点 和 每 种 类 别 有 哪 些 优秀 的 成 员 。 





9.1.1 MVC 框架 

MVC 框架 是 从 传统 的 软件 开发 演进 而 来 的 ， 之 前 的 软件 开发 都 是 使 用 MVC 模式 ， 也 就 
是 模型 -视图 -控制 器 (Model-View-Controller) 。 当 MVC 诞生 的 时 候 ，Web 服务 还 不 存在 ， 
当时 的 软件 架构 主要 是 客户 端 在 原始 网 络 中 与 单一 数据 库 进 行 会 话 。 由 于 MVC 历史 久远 ， 影 


响 力 也 很 大 ， 所 以 一 直 都 有 很 多 追随 者 。 

Node.js 官方 推荐 的 Express 框架 就 是 属于 MVC 框架 的 一 种 。 在 Node.js 的 MVC 框架 中 
还 存在 两 个 小 的 分 支 ， 分 别 为 Sinatra-like 和 Rails-like。Sinatra 和 Rails 都 是 Ruby 语言 的 Web 
框架 ， 后 者 的 影响 力 更 大 、 更 为 知名 。 

Sinatra-like 框架 的 高 度 可 配置 ， 注 重 开发 自由 度 ， 代 表 性 的 Nodejs Web 框架 有 : 





@ Express (官方 网 址 为 http://expressjs.com/ ) ，Node.js 官方 推荐 。 
@ Hapi (官方 网 址 为 http://hapijs.com/ ) 。 

@ Koa.js (官方 网 址 为 http://koajs.com ) 。 

@ flaliron (官方 网 址 为 http://flatironjs.org/ ) 。 

@ totaljs (官方 网 址 为 http://www.totaljs.com/ ) 。 

@ ”locomotive ( 官方 网 址 为 http://locomotivejs.org/) 。 

图 


9.1 是 最 常用 的 上 述 几 个 框架 的 对 比 。 


Metric Express.js Koa.js Hapi.js 
Github Stars 16,158 4,846 3,283 
Contributors 163 49 95 
Packages that depend on: 3,828 99 102 
StackOverflow Questions 11,419 72 82 


9.1 框架 对 比 

Rails 风格 则 是 指 不 重复 自己 和 约定 优 于 配置 ， 以 及 严格 遵循 MVC 结构 开发 ， 代 表 性 的 
框架 有 : 

@ Sails.js (官方 网 址 为 http://sailsjs.org/ ) 。 

@ geddy (官方 网 址 为 http://geddyjs.org/ ) 。 

@ CompoundJS (官方 网 址 为 http://compoundjs.com/) 。 

这 两 种 风格 无 所 谓 谁 优 谁 劣 ,全 赁 使 用 者 的 偏好 。 从 目前 的 情况 来 看 Sinatra-like 的 Express 
是 最 受 欢 迎 的 Node.js 框架 ， 也 是 Nodejjs 官方 推荐 的 唯一 框架 。 


9.1.2 ”全 栈 框架 


全 栈 框架 (Full-stack frameworks) 的 官方 解释 是 : 这 是 Node.js 真正 的 闪光 点 ， 拥 有 大 量 
的 脚手架 、 模板 引擎 和 稳定 持续 的 开发 库 资 源 , 能 够 让 你 在 短 时 间 内 迅速 构建 一 个 实时 的 可 扩 
展 的 Web 应 用 程序 .全 栈 框架 也 是 Node.js 框 架 家 族 中 成 员 最 多 的 一 类 框架 , 大 名 鼎鼎 的 Meteor 
和 MEAN 都 是 属于 全 栈 框架 的 ， 可 以 让 你 轻松 构建 一 个 大 型 的 Web 应 用 ， 而 不 用 在 诸多 细节 
上 浪费 大 量 的 时 间 。 全 栈 框架 的 部 分 成 员 如 下 : 

@ AllcountS (官方 网 址 为 http://allcountjs.com/ ) 。 
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Derby ( 官方 网 址 为 http://derbyjs.com/ ) 。 

Feathers ( 官方 网 址 为 http://feathersjs.com/ ) 。 
SocketStream ( 官方 网 址 为 http://socketstream.org/ ) 。 
MEAN.js (官方 网 址 为 http://meanjs.org/ ) 。 

MEAN.io ( 官方 网 址 为 http://mean.io/ ) 。 

Meteor ( 官方 网 址 为 http:/meteor.com/) 。 

Meatier ( 官方 网 址 为 https://github.com/mattkrick/meatier ) 。 
TWEE.IO ( 官方 网 址 为 http://twee.io/ ) 。 

Mojito ( 官方 网 址 为 http://developer.yahoo.com/cocktails/mojito/ ) 。 
Seedsjs (官方 网 址 为 http://seedsjs.com/ ) 。 

SANE ( 官方 网 址 为 http://sanestack.com/) 。 


9.1.3 REST API 框架 

REST 框架 起 源 于 2000 年 左右 ， 是 由 著名 的 HTTP 协议 设计 者 之 一 的 Fielding 提出 来 的 。 
REST 框架 也 是 目前 流行 的 一 种 互联 网 软件 架构 。 其 中 ，REST 分 别 代表 资源 (Resources) 、 
表现 层 (Representation) pm (State Transfer) 。 它 结构 清晰 、 符 合 标准 、 易 于 理解 、 
扩展 方便 , 所 以 得 到 越 来 越 多 网 站 的 采用 , 并 且 非 常 适合 那些 需要 在 客户 端 表现 丰富 的 应 用 程 
序 。Node.js 家 族 中 属于 REST 类 的 框架 也 不 少 ， 主 要 有 以 下 一 些 比 较 出 名 的 框架 ; 
actionHerojs ( 官方 网 址 为 http://www.actionherojs.com/ ) 。 
Frisby ( 官方 网 址 为 http://frisbyjs.com/ ) 。 
restling ( 官方 网 址 为 https://github.com/lucasfeliciano/restling ) 。 
restify ( 官方 网 址 为 http://restify.com/ ) 。 
restmvc ( 官方 网 址 为 https://github.com/keithnlarsen/restmve.js ) 。 
percolator ( 官方 网 址 为 http://percolatorjs.com/ ) 。 
LoopBack ( 官方 网 址 为 https://strongloop.com/node-js/loopback-framework/ ) 。 
facet ( 官方 网 址 为 http://facet.github.io/platform/ ) 。 
Raddish ( 官方 网 址 为 http://getraddish.com/ ) 。 


9.1.4 其 他 框架 


除了 以 上 提 到 的 三 大 类 框架 外 , 还 有 一 些 无 法 很 好 地 进行 分 类 , 我 们 一 般 把 它们 归 为 单独 
的 一 个 类 别 ， 主 要 包含 中 间 件 、 开 发 库 和 静态 网 站 的 生成 器 等 。 其 中 ， 主 要 代表 有 : 

® Connect (https://github.com/senchalabs/connect#readme ) 。 

® Kraken (http://krakenjs.com/) 。 

® ewdGateway2 (https://github.com/robtweed/ewdGateway2) 。 

@ Wintersmith (https://github.com/jnordberg/wintersmith ) 。 
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® docpad (http://docpad.org/) . 
@ Blacksmith (http://blacksmith.jit.su/) 。 


® romulus (https://github.com/felixge/node-romulus ) 。 


除了 按照 上 面 的 分 类 方式 之 外 ，Nodejjs 的 框架 也 经 常 被 分 为 实时 框架 (Real-time 


framework) 和 非 实 时 框架 。 


实时 框架 是 指 包 含 了 WebSocket 的 双向 通信 功能 ， 能 够 在 服务 器 和 客户 端 做 到 实时 通信 


的 框架 。 非 实时 框架 无 法 做 到 实时 通信 。 


服务 端 和 客户 端 自 由 通信 的 需求 一 直 都 在 , 由 于 HTTP 协议 本 身 的 局 限 性 而 催生 了 Comet 
等 变通 的 方法 ,即使 这 样 也 离 实 时 相距 其 远 。 当 Nodejs 兴起 后 , 另 一 个 HTML 5 技术 WebSocket 
渐渐 成 熟 。 人 们 突然 发 现 ， 实 时 通信 一 下 子 方便 简单 了 。 于 是 WebSocket 技术 在 Nodejs 中 得 
到 大 量 的 应 用 ,其 中 最 为 知名 的 模块 就 是 socketio， 而 各 种 全 栈 框架 也 纷纷 加 入 实时 特性 来 应 
对 更 广阔 的 开发 需求 。 目 前 有 代表 性 的 实时 框架 有 Meteor、MEAN.io、Derby、SocketStream。 

目前 在 互联 网 上 实时 通信 的 应 用 场景 并 不 是 很 多 ， 其 中 大 多 集中 于 聊天 室 、to-do、 实 时 
图 表 、 在 线 游戏 等 领域 。 其 他 领域 使 用 实时 特性 不 但 没 必 要 ， 而 且 是 对 服务 器 资源 的 浪费 。 因 
此 目前 是 否 要 采用 实时 框架 也 要 视 具 体 的 项 目 而 定 。 








一 由 于 Nodejs 还 很 年 轻 ， 目 前 并 没有 WordPress 这 样 比较 完善 的 程序 ， 因 此 如 果 在 Nodejs 


可 以 尝试 一 些 开源 的 程序 ， 比 如 要 用 Nodejs 做 博客 ， 有 Hexo、Ghost 等 。 这 一 框架 的 完 
善 性 使 其 被 称 为 LAMP (Linux+Apache+MySQL+PHP) 的 接班 人 。 


| 开发 里 想 快速 开发 出 自己 想 要 的 应 用 ， 框 架 是 必然 的 选择 。 如 果 是 某 些 特定 类 型 的 应 用 ， 











9 @ 2 Express 框架 介绍 


Express 框架 是 Node.js 基金 会 的 一 个 项 目 ， 官 方 网 址 为 http://expressjs.com〔 中 文 网 站 为 


http://expressjs.com/zh-cn/) 。 它 提供 了 对 Node.js 


原生 API 比较 好 的 封装 ， 从 而 使 开发 者 更 加 


容易 使 用 Node.js， 并 用 来 开发 强壮 的 Web、 移 动 应 用 ， 以 及 API 的 一 些 其 他 功能 。 开 发 人 员 
还 能 够 方便 地 为 它 开发 插件 和 扩展 ， 从 而 增加 Express 的 能 力 。 
通过 使 用 Node Express， 可 以 使 用 更 少 的 代码 来 实现 功能 。 至 少 通过 使 用 Node Express 


可 以 实现 中 间 件 来 响应 http 请 求 ， 可 以 定义 路 由 





用 模板 引擎 来 输出 html 页 面 。 


表 来 定义 对 不 同 请 求 的 响应 函数 ， 还 可 以 使 


Express.js 无 疑 是 当前 Node.js 中 最 流行 的 Web 应 用 程序 框架 ， 甚 至 Sails.js 这 样 的 流行 框 


架 也 是 基于 Expressjs 的 。 
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必 司 Express 没有 数据 库 概念 ， 留 给 第 三 方 Node 块 实现 ， 因 此 几乎 可 以 接 入 任何 数据 库 。 


Express 的 API 有 2.x 版 本 、3.x 版 本 和 4.x 版 本 。 其 中 ，2.x 和 3.x 已 经 基本 不 用 了 ， 建 议 
读者 使 用 API 4.x 版 本 ， 其 在 线 文档 地 址 为 http://expressjs.com/zh-cn/4x/api.html。 下 面 列 出 一 
些 Express 提供 的 基本 功能 : 

@ ”可 以 和 任何 第 三 方 数据 库 进行 通信 。 

@ ”可 以 使 用 任何 的 用 户 认证 方式 。 

@ ”可 以 使 用 任何 符合 Express 接口 定义 的 模板 引擎 。 

@ ”可 以 按照 需要 定义 工程 目录 。 


对 于 一 个 Node.js 开发 新 手 来 说 ，Express 还 提供 了 如 下 好 处 : 


@ Express 的 学 习 曲 线 并 不 陡峭 ， 可 以 很 快 上 手 。 
@ ”Express 有 非常 庞大 的 社区 和 组 织 良 好 的 文档 。 新 手 可 以 很 容易 得 到 所 需要 的 一 切 。 


Express 丰富 的 资源 是 其 他 框架 所 无 法 比拟 的 。 这 也 是 Express 框架 的 一 大 优势 。 下 面 列 
举 Express 社区 的 常用 资源 。 


@ 邮件 发 送 列表 : 在 Google Group 中 加 入 超过 2000 名 Express 用 户 的 行列 ， 浏 览 超过 
5000 个 讨论 。 

@ Gitter: strongloop/express 聊天 室 是 对 Express 相关 的 日 常 讨论 感 兴趣 的 开发 人 员 的 
理想 去 处 。 

@ ”IRC 频道 : 数 百名 开发 人 员 每 天 参与 讨论 freenode 的 #express 话题 。 如 果 存 在 有 关 杠 
架 的 问题 ， 可 马上 加 入 讨论 以 获得 快速 反馈 。 

@ 示例 : 可 以 查看 存储 库 中 数 十 个 Express 应 用 程序 示例 。 这 些 示 例 涵盖 从 API 设计 和 
认证 到 模板 引擎 集成 的 一 切 内 容 。 

















在 Express 中 ，404 响应 不 是 错误 的 结果 ， 所 以 错误 处 理 程序 中 间 件 不 会 将 其 捕获 。 此 行 
为 是 因为 404 响应 只 是 表明 缺少 要 执行 的 其 他 工作 。 换 言 之 ，Express 执行 了 所 有 中 间 件 
函数 和 路 由 ， 且 发 现 它们 都 没有 响应 。 我 们 要 做 的 只 是 在 堆栈 的 最 底部 在 其 他 所 有 函数 
之 下 ) 添加 一 个 中 间 件 函数 来 处 理 404 响应 : 
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O 了 
3 了 。=， Meteor 框架 介绍 


Meteor 框架 是 Node.js 最 出 色 的 全 栈 框架 , 可 以 说 是 除了 Express 之 外 最 火 的 Nodejs 框架 。 
Meteor 的 项 目 在 GitHub 上 有 28k+ 的 赞 ,拥有 大 量 的 自 定义 包 、 庞 大 的 社区 支持 、 非 常 好 的 教 
程 和 文档 ; 在 国内 也 有 大 量 的 粉丝 和 拥护 者 。 在 全 栈 框架 中 ，Meteor 毫 无 疑问 是 王者 ， 我 们 
可 以 用 它 构建 纯 JavaScript 的 实时 Web 和 手机 应 用 。 

无 论 是 服务 器 端的 数据 库 访问 、 商 业 逻 辑 实 现 还 是 客户 端的 展示 ， 在 Meteor 中 所 有 的 流 
程 都 可 以 进行 无 颖 连接。 整个 框架 使 用 统一 的 APL, Meteor API 同时 适用 于 客户 端 和 服务 器 端 。 

Meteor 使 用 的 DDP 协议 可 以 让 我 们 在 后 端 连接 简单 的 数据 库 服务 、 企 业 数据 仓库 甚至 
IOT 传感器 。Meteor 带 有 自己 默认 的 栈 ， 又 有 足够 的 灵活 性 ， 可 以 让 我 们 选择 自己 的 技术 方 
案 。 如果 不 需 要 尝试 其 他 的 框架 或 者 没有 其 他 的 条 件 限 制 , 可 以 直接 使 用 默认 配置 进行 快速 的 
应 用 开发 。 

Meteor 拥有 专业 化 的 开发 团队 、 顶 级 风 投 的 大 量 资金 支持 ， 时 刻 保持 业界 领先 。Meteor 
在 国内 也 有 专门 的 中 文 社区 和 很 多 中 文 视频 教程 ， 非 常 适合 初学 者 自学 。 

下 面 是 Meteor 的 一 些 资源 列表 : 


@ Meteor 官方 网 站 ( https:/www.meteor.com/) 。 

Meteor 官方 文档 ( http://docs.meteor.com/#full/24 ) 。 

Meteor 相关 问题 ( http://stackoverflow.com/questions/tagged/meteor10 ) 。 

Meteor 中 文教 程 (http://zh.discovermeteor.com/chapters/getting-started/62 ) 。 
开始 Meteor (http://joshowens.me/getting-started-with-meteor-js/33 ) 。 

Meteor 的 一 些 包 推荐 ( https://gentlenode.com/journal/meteor-22-the-best-meteor- 


























packages-you-must-know-to-code-faster-than-ever/5241 ) 。 
Meteor 中 文 社区 ( http://www.meteorhub.org/ ) 。 


名 .人 引 ， 其 他 框架 


9.4.1 Sails.js 


Sailsjs (Nodejs MVC) 由 Mike McNeil 创建 ， 在 MIT 协议 下 开源 ， 现 在 由 Treeline and 
balderdash 提供 支持 。Sails 作为 一 个 非常 稳固 的 Nodejs 框架 ,提供 了 建立 任何 规模 的 Web 应 
用 所 需要 的 所 有 功能 。 

Sailsjjs 在 底层 使 用 Express 框架 来 提供 对 http 请 求 的 处 理 ， 同 时 使 用 Socket.IO 框架 来 处 
理 WebSocket 请 求 。 作 为 一 个 前 端 应 用 开发 框架 ， 它 允许 开发 人 员 选 择 他 们 熟悉 的 技术 来 开 
发 应 用 。 
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Sailsjs 还 通过 waterline 框架 实现 了 ORM 功能 。 通 过 这 个 功能 ， 应 用 程序 在 不 进行 大 的 
修改 的 前 提 下 ， 可 以 从 一 个 后 端 数据 库 切换 到 另外 一 个 后 端 数据 库 〈 也 可 以 是 一 个 NoSQL 数 
据 库 ) 。 

Sails 特别 适合 用 来 开发 对 数据 的 实时 更 新 有 较 高 要 求 的 应 用 ， 比 如 多 人 棋 类 游戏 、 单 页 
Web 应 用 等 。 如 果 读 者 对 Ruby、Django 或 者 Zend 有 一 定 的 了 解 ， 就 非常 容易 理解 Sail 中 的 
概念 了 。 

简单 来 说 ，Sailsjs 既 给 开发 者 提供 了 一 个 优秀 的 MVC 框架 ， 也 提供 了 一 定 的 灵活 性 ， 让 
开发 者 可 以 自主 选择 前 端 开发 方式 和 后 端的 数据 库 。 


9.4.2 Derby.js 


Derby.js (全 栈 框架 ) 跟 它 的 直接 竞争 对 手 Meteor、Mean.io 和 Mojito 一 样 ， 也 是 一 个 全 
栈 框架 。 它 运行 在 Nodejs + Mongo + Redis 的 上 层 。Derby 的 主要 部 分 是 一 个 叫 作 Racer 的 数 
据 同步 引擎 。 它 能 够 让 数据 在 数据 库 、 服 务 器 和 浏览 器 之 间 的 同步 变 得 轻而易举 。 

Racer 的 确 能 够 让 基于 Derby 框架 的 应 用 运行 得 更 快 。 无 论 是 在 浏览 器 端 还 是 服务 器 端 ， 
对 于 单 页 面 应 用 来 说 ， 它 都 是 一 个 完美 的 选择 方案 。Derby 经 常 被 用 来 和 业界 老大 Meteor 进 
行 比较 ，Meteor 项 目 已 经 开发 了 一 段 时 间 ， 因 而 能 够 提供 更 多 的 开 箱 即 用 功能 ， 使 在 更 短 时 
间 内 开发 复杂 的 Web 应 用 变 得 更 加 容易 。 

Derby 更 适合 于 需要 更 快运 行 速度 的 应 用 ， 并 且 它 的 模块 化 方式 能 够 让 应 用 更 灵活 、 更 容 
易 扩 展 。Derby 最 近 的 发 展 有 些 缓慢 ， 但 它 并 没有 出 局 ， 仍 有 改写 Node.js 全 栈 框架 游戏 规则 
的 潜力 。 


9.4.3 Flatiron.js 


Flatiron.js (Node.js MVC 框架 ) 背后 的 核心 思想 是 让 你 能 使 用 它 所 提供 的 组 件 以 及 一 些 第 
三 方 库 构 建 自己 的 全 栈 框架 。 然 而 , 这 带 来 的 是 更 高 的 复杂 度 ， 并 有 可 能 会 被 使 用 错误 组 件 的 
开发 者 搞 得 一 团 糟 。 

Flatiron 是 一 个 由 多 个 相互 独立 的 组 件 松散 地 组 建 起 来 的 全 栈 MVC 框架 。 它 支持 Director， 
这 是 一 个 从 头 到 脚 都 使 用 JavaScript 搭建 起 来 的 ， 并 不 需要 任何 依赖 项 的 URL 路 由 组 件 。 

通过 一 个 叫 Plates 的 模板 引擎 ，Flatiron 能 够 支持 模板 语言 ， 然 而 数据 管理 是 通过 JSON 
实现 的 ， 并 能 与 任何 一 种 数据 库 一 起 使 用 。Flatiron 现在 由 Nodejitsu 以 及 其 他 的 社区 成 员 进 行 
维护 ， 并 且 做 得 相当 不 错 ， 是 一 个 不 那么 流行 却 值得 一 看 的 框架 。 





9.4.4 Hapi 

Hapi 是 为 数 不 多 的 不 依赖 于 Express 的 Node.js 框架 ， 现 在 甚至 已 经 完全 独立 于 Express 
了 。 在 最 近 一 段 时 间 ， 很 多 开发 者 选择 了 Hapi， 而 非 Express， 这 使 得 Hapi 或 多 或 少 变 为 了 
Express 的 莞 争 对 手 。 

Hapi 在 众多 Node.js 框架 中 并 非 一 个 老牌 选手 , 然而 它 却 成 功 地 在 这 当中 创造 了 自己 的 一 
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个 生态 圈 。Hapi 致力 于 完全 地 分 离 node HTTP 服务 器 、 路 由 以 及 业务 逻辑 ， 并 更 多 地 聚焦 于 
如 何 尽 可 能 通过 配置 而 非 代码 来 控制 。 

Hapi 最 初 是 由 Eran Hammer 以 及 在 Walmart labs 的 团队 为 了 工作 需要 而 开发 的 。 其 后 便 
以 极 快 的 速度 受到 了 欢迎 ， 现 在 已 在 MIT 许可 下 成 为 一 个 开源 的 框架 ， 能 够 免费 地 被 下 载 和 
使 用 。 

迪士尼 、 雅 虎 、Pebble、beats 音乐 以 及 Walmart 这 样 的 公司 都 在 使 用 Hapi 作为 一 个 或 多 
个 项 目的 网 络 应 用 框架 。Hapi 的 影响 力 可 见 一 斑 。 


9.4.5 Mean.IO 


Mean 是 Mongo DB、Express、Angular 和 Node.js 捆绑 在 一 起 的 组 合 。 基 本 上 可 以 说 只 要 
有 Mean， 你 就 拥有 了 数据 库 层 、 服 务 器 端 和 网 页 前 端的 整套 工具 ， 足 以 开发 所 有 类 型 的 现代 
网 络 应 用 。 

Mean 是 一 个 完整 独立 的 包 ， 涵 盖 了 应 用 开发 的 所 有 方面 ， 尤 其 适合 于 那些 需要 快速 开始 
开发 的 人 。 它 内 置 多 种 技术 , 而 且 在 联合 使 用 时 表现 非常 好 ,可 以 用 于 创建 任意 大 小 和 复杂 度 
的 应 用 。 

使 用 Mean， 开 发 者 可 以 避免 经 历 混合 和 匹配 不 同 的 技术 栈 。 通 过 Mean 栈 ， 可 以 减少 安 
装 和 配置 MongoDB、Express、Angular 和 Nodejs 需要 的 时 间 。Mean.io 的 另 一 个 巨大 好 处 就 
是 所 有 的 栈 都 使 用 JavaScript。 
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mean.js 是 mean 的 一 个 分 支 ，meanjs 已 经 成 为 一 个 独立 的 Node.js 框架 ， 并 且 也 相 四 
\ fT 











9.4.6 Mojito 

Mojito 由 Yahoo 开发 并 迅速 取得 成 功 ， 只 是 很 快 就 带 着 关于 框架 的 空前 成 功 坐 到 了 冷 板 
使 ， 就 像 Meteor 和 Mean stack 那样 。 

Mojito 同样 是 一 个 MVC 应 用 框架 ， 非 常 适合 于 创建 使 用 HTML 5、JavaScript 和 CSS 3 
的 高 性 能 网 络 和 手机 应 用 。Mojito 的 根本 目标 是 提供 一 个 框架 , 用 于 构建 标准 的 基于 跨 平台 的 
应 用 ， 使 之 可 以 同时 运行 在 客户 端 和 服务 器 端 并 实现 高 性 能 。 


9.4.7 Socket Stream 


Socket Stream 是 一 个 专注 于 客户 端 和 服务 端 数据 的 快速 同步 的 实时 框架 ， 致 力 于 前 后 端 
数据 的 实时 更 新 。 它 最 大 的 特点 是 不 严格 要 求 使 用 指定 的 客户 端 技术 ， 也 不 限定 数据 库 的 
ORM。 它 更 适合 做 单 页 Web 应 用 、 多 用 户 游戏 、 聊 天 客户 端 、 网 络 应 用 、 交 易 平台 以 及 所 有 
需要 将 数据 从 服务 端 实时 推送 到 客户 端的 应 用 。 

服务 端 和 客户 端 使 用 JSON 来 传输 数据 ， 比 较 理 想 的 是 使 用 WebSockets 在 服务 端 事件 发 
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生 时 自动 将 数据 推送 到 客户 端 。Socket Stream 由 Owen Barnes 创建 ， 现 由 Paul Jensen 和 团队 
维护 。 

Socket Stream 获得 了 很 好 的 发 展 , 其 他 类 似 的 优秀 框架 还 有 total.js、Geddy.JS、Locomotive、 
compound 和 Restify 。 


9.4.8 Bearcat 


Bearcat 是 网 易 pomelo 项 目 团队 开发 的 一 个 基于 POJOs 进行 开发 的 应 用 层 框架 。Bearcat 
提供 了 一 个 轻 量 级 的 容器 来 编写 简单 、 可 维护 的 Node.js。Bearcat 提供 了 一 个 基础 的 底层 来 管 
里 应 用 逻辑 对 象 , 使 开发 者 可 以 把 精力 放 在 应 用 层 的 逻辑 编写 上 。 核心 和 Beans 模块 提供 容器 
的 基础 部 分 ， 包 含 IoC 容器 和 依赖 注入 。BeanFactory 是 一 个 复杂 的 factory 工厂 模式 实现 。 
Bearcat 去 除了 手动 编写 单 例 ， 允 许 实际 程序 逻辑 从 配置 和 依赖 的 管理 中 解 厢 ， 网 址 为 
http://bearcatnode.github.io/bearcat/。 














名 . 5 ”如何 选 择 适 合 自己 的 框架 


当 开 发 应 用 程序 时 ， 需 要 选择 整合 各 种 工具 、 库 和 框架 到 应 用 程序 中 。 在 面 对 这 么 多 
Node.js 框架 的 时 候 ， 可 能 一 时 有 点 不 知 所 措 ， 尤 其 是 在 不 熟悉 它们 的 时 候 ， 并 且 这 些 框架 和 
技术 每 天 都 在 不 断 地 更 新 。 

在 某 些 情况 下 ， 选 择 最 流行 和 广 受 好 评 的 工具 是 比较 容易 的 ， 只 需要 在 GitHub 查看 一 下 
热度 就 能 了 解 。 然 而 ， 情 况 不 总 是 这 样 。 在 很 多 时 候 ， 有 多 个 框架 同时 都 适合 基本 需求 ， 并 且 
都 有 各 自 的 长 处 。 同 时 ， 开 发 者 还 要 考虑 和 旧 系 统 的 兼容 性 以 及 项 目 以 后 的 发 展 方向 等 因素 。 


9.5.1 选择 框架 时 的 考虑 事项 
选择 框架 的 时 候 一 般 需 要 考虑 以 下 几 点 : 


(1) 实用 性 。 与 项 目 需求 的 结合 度 是 否 充分 ， 例 如 当前 需要 的 是 UI 框架 ， 就 不 应 该 找 
网 络 方面 的 东西 , 反之 需要 一 个 图 片 加 载 内 存 优化 的 框架 , 也 不 可 能 去 找 一 个 多 线程 下 载 的 杠 
架 。 例 如 ， 考 虑 一 个 XML 解析 库 。 它 应 该 可 以 创建 一 个 DOM， 然 后 返回 一 个 组 织 良 好 的 错 
误 列 表 。 

(2) 兼容 性 。 一 个 框架 可 能 所 使 用 的 技术 非常 新 颖 ， 但 是 它 是 否 会 与 其 他 正在 使 用 的 库 
产生 不 兼容 呢 ? 这 种 冲突 在 JS 开发 中 经 常 发 生 。 例 如 ,你 可 能 会 使 用 Prototype 作为 JS 框架 ， 
但 是 当 你 寻找 内 嵌 的 HTML 编辑 器 时 ， 需 要 检查 它们 是 否 与 现 有 的 Prototype 版 本 兼容 。 如 果 
想 继续 使 用 之 前 用 过 的 JavaScript 库 ， 就 需要 查看 这 个 库 是 否 在 新 的 框架 能 够 兼容 。 

(3) 扩展 性 。 对 于 任何 解决 实际 问题 的 框架 来 说 ， 你 将 或 多 或 少 地 需要 定制 或 者 扩展 它 。 
在 Java 中 , 可 以 通过 接口 来 完成 。 我们 回头 看 XML 解析 器 的 问题 ， 可 以 通过 实现 特殊 的 接口 
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并 提供 给 解析 器 来 创建 一 个 自 定义 的 错误 处 理 。 这 种 类 型 的 定义 是 非常 直接 的 , 在 大 多 数 框架 
中 也 是 可 行 的 。 另 一 种 扩展 是 使 用 插件 。 虽 然 不 同 应 用 程序 定义 插件 的 方式 不 同 ， 但 是 一 般 来 
说 总 是 将 代码 “ 丢 ” 到 一 个 预先 定义 的 方法 中 。 例 如 ， 一 些 内 嵌 的 HMTL 编辑 器 允许 把 JS 代 
码 放 到 一 个 特定 的 目录 。 这 段 代 码 必须 符合 某 些 规范 ， 就 像 实现 Java 接口 一 样 。 插 件 是 一 个 
有 趣 的 模型 ， 因 为 它们 让 你 创建 原始 框架 所 不 具备 的 特性 。 这 种 方式 是 非常 强大 的 。 

(4) 成 熟 度 。 框 架 的 代码 是 否 便于 商用 开发 、 技 术 是 否 相 对 成 熟 、 是 否 能 够 长 期 稳定 地 
发 展 ? 如 果 是 开源 的 框架 , 就 需要 考虑 所 使 用 的 开源 协议 对 商业 项 目 是 否 友好 、 开 源 协议 有 没 
有 感染 性 等 。 

(5) 资源 及 易 用 性 。 这 样 方便 上 手 ， 也 容易 在 团队 中 推广 使 用 。 好 的 框架 一 般 都 会 有 一 
个 比较 好 的 社区 支持 , 出 了 问题 能 够 方便 地 找到 解决 方案 , 能 够 让 开发 者 持续 维护 并 能 够 及 时 
解决 Bug。 这 样 就 能 够 节省 团队 中 维护 框架 的 成 本 。 成熟 的 框架 总 是 比 新 的 竞争 者 有 更 多 的 帮 
助 资源 。 社 区 论坛 、 邮 件 列 表 、 博 客 ， 其 至 像 StackOverflow 这 样 的 站 点 都 提供 了 丰富 的 帮助 
资讯 。 你 调查 的 框架 是 否 有 活动 的 社区 、 邮 件 列表 、StackOverflow 的 权威 回复 ， 能 够 回答 关 
于 框架 的 大 量 问 题 ? 在 学 习 一 个 新 工具 的 过 程 中 , 寻找 帮助 和 样 例 代码 总 是 极为 重要 的 。 看 博 
客 也 非常 有 帮助 ， 因 为 它 会 告诉 你 谁 在 谈论 这 个 框架 。 

(6) 可 定制 化 。 框 架 能 够 自己 进行 定制 和 修改 。 随 着 应 用 程序 开发 的 不 断 深入 ， 这 样 可 
以 满足 应 用 程序 更 加 复杂 的 要 求 ， 让 项 目 不 受制 于 原 有 框架 的 局 限 性 ， 能 够 更 加 灵活 。 


9.5.2 选择 框架 的 建议 
下 面 针 对 各 种 不 同类 型 的 应 用 开发 给 出 一 些 框架 选择 的 建议 。 
(1) 简单 Web 开发 : 框架 选择 Express + EJS + Mongoose/MySQL 
通常 用 Node.js 做 Web 开发 ， 需 要 3 个 框架 配合 使 用 ， 就 像 Java 中 的 SSH。Express 是 轻 
量 灵活 的 Node.js Web 应 用 框架 。EJS 是 一 个 嵌入 的 JavaScript 模板 引擎 , 通过 编译 生成 HTML 
代码 .Mongoose 作为 MongoDB 的 对 象 模型 工具 ,通过 Mongoose 框架 可 以 进行 访问 MongoDB 
的 操作 。mysql 是 连接 MySQL 数据 库 的 通信 API， 可 以 进行 访问 MySQL 的 操作 。 


(2) 聊天 室 (IM) : 框架 选择 Express + socket.io 
socket.io 是 一 个 基于 Node.js 架构 体系 、 支 持 WebSocket 协议 、 用 于 实时 通信 的 软件 包 。 
socket.io 给 跨 浏 览 器 构建 实时 应 用 提供 了 完整 的 封装 ， 完 全 由 JavaScript 实现 。 


(3) 疏 虫 : 框架 选择 Cheerio/Request 

Cheerio 是 一 个 为 服务 器 特别 定制 的 快速 、 灵 活 、 封 装 jQuery 核心 功能 的 工具 包 。Cheerio 
包括 jQuery 核心 的 子 集 ， 从 jQuery 库 中 去 除了 所 有 DOM 不 一 致 性 和 浏览 器 不 兼容 的 部 分 ， 
揭示 了 它 真正 优雅 的 API。Cheerio 工作 在 一 个 非常 简单 、 一 致 的 DOM 模型 之 上 ， 解 析 、 操 
作 、 演 染 都 变 得 难以 置信 的 高 效 。 基 础 的 端 到 端的 基准 测试 显示 Cheerio 大 约 比 JSDOM 快 8 
倍 (8x) 。 
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(4) 博客 系统 : 框架 选择 Hexo 





Hexo 是 一 个 简单 、 轻 量 、 基 于 Node 的 静态 博客 框架 ， 甚 至 可 以 媲美 WordPress。 通 过 
Hexo 可 以 快速 创建 自己 的 博客 ， 仅 需要 几 条 命令 就 可 以 完成 。 发 布 时 ，Hexo 既 可 以 部 署 在 自 
己 的 Node 服务 器 上 面 ， 也 可 以 部 署 在 GitHub 上 面 。 基 于 GitHub 的 个 人 站 点 逐渐 流行 起 来 。 
对 于 个 人 用 户 来 说 ， 部 署 在 GitHub 上 好 处 颇 多 ， 不 仅 可 以 省 去 服务 器 的 成 本 ， 还 可 以 减少 各 


种 系统 运 维 的 麻烦 事 〈 系 统管 理 、 备 份 、 网 络 ) 。 
(5) 论坛 : 框架 选择 Node Club 


Node Club 是 用 Nodejs 和 MongoDB 开发 的 新 型 社区 软件 ， 界 面 优雅 ， 功 能 丰富 ,小 巧 迅 
速 ， 已 在 Nodejs 中 文 技术 社区 CNode〈 见 图 9.2) 得 到 应 用 。 我 们 完全 可 以 用 它 搭建 自己 的 





关于 node_reds 的 桥 误 处 理 问题 ， 牙 新 emor 事 件 不 起 效 ,并 白 此 引申 出 一 蔓 同 基地 195 


发 讲解 express 中 sesslon 中 则 件 的 使 用 方法 . 国 :de 


社区 。 

cnedes ? 

当前 运用 

前 /7 packages json 中 各 么 渗 W0 注 后 7 2 人 4 和 
上 ”65230 我 与 了 一 个 时 间 管 理 尖 的 社区 ， 求 大 神 稚 宝 [Ed 
关 2 node webktHffM 的 node 包 ,也 科 要 打 名 进 mw 文件 么 ? so 
国 ,Frameqwenme +1 S00 
国 CR] mnoces Erpressiip ee , CS, Eee 刁 罗 4 
2 12014 长 明 拒 聘 node 上 人 员 14 昌 革 
11/2639 用 anguiar*node 写 了 一 个 demo 阐 1m 
篇 Cp] noces— 人 Ne 本 14 
前 "机 有 人 古事 种 工具 对 代 丙 的 恪 式 化 支持 最 好 ? 14 相 前 
pn 6 

器 21 


图 9.2 CNode 


(6) 控制 台 工具 : 框架 选择 ttyjs 


无 人 目 复 的 笑 归 


[求购 ] reque 的 5 要 

棍 涡 人 (三 嘱 种 工具 对 代码 的 恪 式 {t 
mongosian 的 db 雹 接站 扯 的 站 
[ANN] 一 个 新 的 卫 填 文件 工具 

款 们 前 拿 PhartoruS 干 昼 引 的 ? 


ES TOP 100 >> 





TNODE 牛 舌 1 一 个 周 去 初学 时 所 IH 2 4 本 上 2645 Weacon 


ttyjs( 见 图 9.3 ) 是 一 个 支持 在 浏览 器 中 运行 的 命令 行 窗口 ,基于 Nodejs 平 台 , 依赖 socketio 
库 ， 通 过 WebSocket 与 Linux 系统 通信 。tty.js 的 特性 是 : 支持 多 Tab 窗口 模型 、 支 持 vim 语 


法 、 支 持 xterm 鼠标 事件 、 支 持 265 色 显 示 、 支 持 session。 
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全 CD 192.168.1.20: 
笠 明 白班 


Light Switch| 








图 9.3 ttyjs 
(7) 在 线 游戏 : 框架 选择 Pomelo 

Pomelo 是 基于 Node.js 的 高 性 能 、 分 布 式 游 戏 服 务 器 框架 , 包括 基础 的 开发 框架 和 相关 的 
扩展 组 件 〈 库 和 工具 包 ) ， 可 以 省 去 游戏 开发 枯燥 中 的 重复 劳动 和 底层 逻辑 的 开发 。 

Pomelo 的 设计 初衷 是 游戏 服务 器 。 不 过 在 设计 、 开 发 完成 后 发 现 Pomelo 是 一 个 通用 的 分 
布 式 实时 应 用 开发 框架 。 它 的 灵活 性 和 可 扩展 性 使 Pomelo 框架 有 了 更 广阔 的 应 用 范围 。 凭 借 
强大 的 可 能 伸缩 性 和 灵活 性 ，Pomelo 在 很 多 方面 甚至 超越 了 现 有 的 开源 实时 应 用 框架 。 

Web 和 应 用 开发 的 变化 是 非常 快 的 ， 对 大 多 数 开 发 人 员 来 说 ， 选 择 一 个 合适 的 框架 依然 
是 非常 困难 的 。 使 用 Node 框架 可 以 让 应 用 程序 迅速 构建 起 来 ， 而 不 用 过 多 地 考虑 底层 设计 ， 
开发 人 员 可 以 关注 扩展 应 用 程序 , 而 不 是 重复 地 制造 已 上 有 的 轮子 。 框架 提供 了 多 样 特性 使 可 以 
在 不 同 的 层面 连接 资源 、 创 建 页 面 、 解 决 构建 实时 的 常见 问题 。 








温 故 知 新 
学 完 本 章 后 ， 读 者 需要 回答 : 


1. Node.js 的 框架 分 为 几 大 类 ， 每 个 类 别 有 哪 些 突出 代表 ? 
2. 在 选择 Node.js 框架 的 时 候 有 哪些 原则 和 注意 事项 ? 
3. 实时 框架 和 非 实 时 框架 分 别 适用 于 开发 哪些 应 用 ? 
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第 10 章 
< Node .js 单元 测试 > 


单元 测试 又 称 为 模块 测试 , 保证 了 程序 中 最 小 可 用 单元 的 可 用 性 。 在 大 型 的 软件 合作 开发 
中 ， 单 元 测试 显得 更 加 重要 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 

@ ”使 用 Mocha 进行 单元 测试 。 

@ 了解 Nodejs 的 原生 测试 模块 。 

@ 了 解 Should.js 库 的 使 用 。 





单元 测试 介绍 


单元 测试 是 指 对 软件 中 的 最 小 可 测试 单元 进行 检查 和 验证 ， 因 此 又 称 为 模块 测试 。 在 
Node.js 中 ， 单 元 测试 往往 是 针对 某 个 函数 或 者 API 进行 正确 性 验证 ， 以 保证 代码 的 可 用 性 。 
这 在 团队 开发 中 显得 尤其 重要 , 因为 团队 成 员 并 不 了 解 其 他 成 员 代码 的 写法 以 及 可 用 性 。 通 过 
单元 测试 ， 既 保证 了 单个 成 员 所 写 代 码 的 可 用 性 ,又 可 以 让 其 他 成 员 通过 测试 内 容 了 解 其 函数 
或 者 API 的 使 用 。 
单元 测试 有 许多 风格 ， 常 见 的 风格 有 行为 驱动 开发 (BDD ) 和 测试 驱动 开发 (TDD) 。 
@ 行为 驱动 开发 (BDD ) 是 一 种 敏捷 软件 开发 的 技术 ， 鼓励 软件 项 目 中 的 开发 者 、QA 
和 非 技术 人 员 或 商业 参与 者 之 间 的 协作 。 也 就 是 说 , 行为 驱动 开发 关注 的 是 整个 系统 
最 终 的 实现 是 否 与 用 户 期 望 一 致 。 

@ ”测试 驱动 开发 (TDD ) 是 一 种 软件 开发 过 程 中 的 应 用 方法 ， 最 早 在 极限 编程 中 倡导 ， 
基本 思想 是 先 写 测试 程序 ,然后 编码 实现 功能 ,测试 驱动 开发 的 目的 是 取得 快速 反馈 ， 
使 所 有 功能 都 是 可 用 的 。 


使 用 单元 测试 模块 Mocha 


MongoDB 是 一 个 基于 分 布 式 文件 存储 的 数据 库 , 由 C++ 语 言 编 写 , 目的 是 为 Web 应 用 提 
供 可 拓展 的 高 性 能 数据 存储 解决 方案 。 























10.2.1 Mocha 介绍 


Mocha 是 现在 最 流行 的 Node.js 单元 测试 框架 ,官方 网 站 为 http://mochajs.org/，GitHub 地 
址 为 https://github.com/mochajs/mocha。Mocha 官方 网 站 界面 如 图 10.1 所 示 。 


simple, flexible, fun 


Mocha is a feature-rich JavaScript test framework running on Node.js and in the browser, 
making asynchronous testing simple and fun. Mocha tests run serially, allowing for flexible and 
accurate reporting, while mapping uncaught exceptions to the correct test cases. Hosted on 
SitHub. 





图 10.1 Mocha 官方 网 站 


从 Mocha 的 官方 网 站 中 可 以 了 解 到 Mocha 不 仅 可 以 运行 在 Nodejs 环境 中 ， 还 可 以 运行 
在 浏览 器 中 。 同 时 ，Mocha 功能 丰富 ,支持 TDD、BDD 和 export 风格 的 测试 ， 并 且 支 持 异步 
和 同步 的 测试 ， 基 本 上 能 够 满足 Node.js 所 有 单元 测试 的 需求 。 

使 用 Mocha 这 个 模块 前 首先 需要 通过 NPM 安装 这 个 模块 : 


或 者 不 需要 全 局 安装 ， 仅 作为 项 目的 依赖 安装 : 


下 面 做 一 个 简单 的 测试 ， 创 建 一 个 名 为 index.js 的 文件 ， 在 这 个 文件 中 写 入 一 个 计算 各 个 
参数 之 和 的 函数 。 


【示例 10-1】 





/* 导 出 模块 */ 
module.exports ={ 
add: add 


接着 对 这 个 函数 进行 测试 , 在 同 级 目录 下 创建 一 个 名 为 test.js 的 文件 , 将 上 述 函 数 引入 后 


进行 测试 ， 写 入 以 下 代码 : 
/* 引 入 需要 测试 的 模块 */ 


Var lib = require('./index'); 


/* 测 试 描述 */ 
describe('Math', function() { 
describe('#add()', function() { 
it('should return 10', function() { 


/* 运 行 方法 */ 
lib.add(5,5); 
}) 
}) 
}); 


【代码 说 明 】 


@@ describe(moduleName，testDetails): 描述 将 要 测试 的 模块 。 例 如 ， 上 述 代码 就 是 测试 


Math 模块 下 的 add(0 方 法 ， 这 个 方法 可 以 谋 套 。 


@ it(info, function): 测试 语句 放 在 回调 函数 中 ，info 是 正确 输出 时 的 简单 语句 描述 。 一 


个 让 对 应 一 个 实际 的 可 能 情况 。 
在 这 个 文件 目录 下 ， 使 用 命令 行 运行 以 下 命令 : 
mocha test 
test 运行 之 后 的 结果 如 图 10.2 所 示 。 
$ mocha test 


Math 


uld return 10 


ing (2 





图 10.2 测试 结 


不 过 此 时 仍然 存在 一 个 问题 ， 就 是 上 面 只 是 运行 了 代码 ， 并 没有 对 结果 进行 检查 


。 例 如 ， 
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对 add0 函 数 传 入 其 他 参数 ， 依 旧 会 得 到 一 样 的 结果 〈 见 图 10.3) : 
/* 引 入 需要 测试 的 模块 */ 


var lib = require('./index'); 


/* 测 试 描述 */ 
describe('Math', function() { 
describe('#add()', function() { 


it('should return 10', function() { 


/* 运 行 方法 */ 
lib.add (3,3); 
}) 
} 
}) 7 


$ mocha test 


Math 


y should return 10 


ing (2 





图 10.3 测试 结果 


中 


对 结果 进行 检查 就 要 用 到 断言 库 。Node.js 中 自 带 了 一 个 断言 库 assert， 如 上 对 add 函数 进 
行 断言 测试 可 以 使 用 assert.equal() 方 法 。 现 将 textjs 文件 中 的 代码 改 为 如 下 代码 : 
/* 引 入 需要 测试 的 模块 */ 


Var lib = require('./index'); 


/* 引 入 断言 模块 */ 


Var assert = require('assert'); 


/* 测 试 描述 */ 
describe('Math', function() { 
describe('#add()', function() { 
it('should return 10', function() { 


/* 测 试 断言 */ 
assert.equal('10',1lib.add(5,5)); 
}); 


/* 测 试 断言 */ 
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it('should return 0', function() { 
assert.equal('0', lib.add()); 
} 
} 
1); 
在 这 个 文件 目录 下 ， 使 用 命令 行 运行 以 下 命令 : 
mocha test 


test 运行 之 后 的 结果 如 图 10.4 所 示 。 


$ mocha test 


ld return 10 
hould return 0 





图 10.4 测试 结果 
此 时 看 上 去 和 上 文 并 没有 什么 区 别 ， 但 是 当 assert.equal() 的 期 望 值 和 实际 值 不 一 致 时 ， 将 
可 以 在 控制 台中 看 到 错误 提示 ， 如 将 add0) 参 数 修改 为 以 下 内 容 ; 
/* 引 入 需要 测试 的 模块 */ 


var lib = require('./index'); 


/* 引 入 断言 模块 */ 


Var assert = require('assert'); 


/* 测 试 描述 */ 
describe('Math', function() { 
describe('#add()', function() { 
it('should return 10', function() { 
/* 测 试 断言 */ 
assert.equal('10',1lib.add(5,5,5)); 
1); 


it('should return 0', function() { 
/* 测 试 断言 */ 
assert.equal('0', lib.add()); 
]) 
} 
1); 


再 次 运行 代码 将 提示 一 个 断言 出 错 ， 如 图 10.5 所 示 。 
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图 10.5 断言 出 错 
assert 模块 的 主要 方法 有 以 下 几 个 : 
® assert.equal() 
® assert.notEqual() 
® assert.fail() 
® assert.deepEqual() 
® assert.notDeepEqual() 


有 关上 有 具体 方法 的 使 用 ， 读 者 可 以 查阅 相关 的 书籍 、 文 档 等 资料 。 


读者 在 这 里 有 必要 了 解 一 下 Mocha 这 个 测试 框架 常用 的 命令 。 
@ 过 mocha -h 或 者 mocha--elp 可 以 查看 所 有 的 命令 信息 ， 如 图 10.6 所 示 。 





图 10.6 mocha help 结果 


@ 通过 mocha -V 或 者 mocha--version 可 以 查看 mocha 的 版 本 ， 如 图 10.7 所 示 。 





图 10.7 mocha 版 本 


@ ”通过 mocha -c 或 者 mocha--colors 强制 测试 时 使 用 颜色 标记 ， 此 时 通过 的 测试 将 为 绿 
色 字 体 ， 未 通过 的 测试 将 为 红色 字体 。 例 如 ， 对 上 述 的 testjs 文件 使 用 这 个 命令 将 得 
到 如 图 10.8 所 示 的 结果 。 
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$ mocha test -c 


Math 
#addO 


1 passing 


1) Math #addO should return 10: 


图 10.8 ” 带 颜 色 的 测试 结果 





@ 通过 mocha-C 或 者 mocha--no-colors 强制 测试 时 不 使 用 颜色 标记 ,对 应 于 上 面 的 命令 。 


10.2.2 ”使 用 断言 库 shouldjs 
在 上 文中 ， 我 们 使 用 Nodejs 中 原生 的 断言 模块 assert 来 做 单元 测试 时 结果 的 判断 。 不 过 


原生 的 assert 模块 功能 有 限 ,这 里 介绍 另 
测试 的 断言 库 ， 宣 方 网 站 的 地 址 是 http://shouldjs.github.io/( 见 图 10.9) ，GitHub 地 址 
https://github.com/shouldjs/should.js。 


Should.js 


global 





noconflict 


assertion 





assertion assert 


Ls.deepEquel 








al 





rictEqua 





ricteqeal 


1 throus 


assertion bool 





falee 





“global” Members 
Assertion.add(name, func) 


cn im subcontext ang this metnod take care about negation 












Assertion.addChain(name, [onCall]) 
Aad cnanng genier to Asserton Ike 3. whicn et 


Arguments 


2 {oncell] al function io cal 
Assertion.alias(from, to) 


Create alas ior Some assertio 








Example 





图 10.9 ”shouldjs 官方 网 站 


- 款 流行 的 断言 库 一 一 should.js。should.js 是 一 个 BDD 


日 
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Node.js 开发 实战 人 


使 用 shouldjs 断言 库 前 首先 需要 通过 NPM 安装 这 个 模块 : 


安装 完成 后 通过 require() 方 法 引入 : 
ar should = require('shouldJ 
使 用 shouldjs 改写 原生 Node.js 的 assert 模块 测试 ， 代 码 如 下 : 





使 用 命令 行 工具 运行 以 下 命令 ， 发 现 测试 结果 符合 预期 : 


有 时 候 测试 中 并 不 需要 明确 的 返回 结果 ， 只 需要 测试 返回 的 数据 类 型 。 这 点 利用 shouldjs 
同样 可 以 做 到 。 将 indexjs 的 内 容 修改 为 以 下 代码 : 
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objType: objType 
}; 











这 段 代 码 非 常 简单 ， 利 用 typeof 检测 参数 的 类 型 ， 从 而 返回 不 同 的 值 。 

使 用 testjs 文件 对 这 个 方法 的 返回 值 的 数据 类 型 进行 测试 ， 将 testjs 文件 的 代码 修改 为 以 
下 代码 : 
/* 引 入 需要 测试 的 模块 */ 


var lib = require('./index'); 








/* 引 入 断言 模块 */ 


Var assert = require('assert'); 


/* 测 试 描述 */ 
describe('Type', function() { 
describe('#objType()', function() { 
it('object should return an object', function() { 
should (lib.objType ({name: 'huruji'})) .be.a.0Object (); 
yx 


it('date should return an object', function() { 
should (lib.objType (new Date())) .be.a.0Object(); 
1D); 


it('reg should return an object', function() { 
should (lib.objType (/^“a/)) .be.a.Object (); 
1); 


以 上 代码 测试 一 个 普通 对 象 、 一 个 Date 对 象 、 一 个 正则 表达 式 作为 参数 时 的 返回 值 。 在 
命令 行 中 运行 以 下 命令 : 
mocha test.js -c 


可 以 看 到 测试 代码 预期 运行 ， 如 图 10.10 所 示 。 


Type 
#0bjType 〇 


V 


V 
可 


3 passing 





图 10.10 ”测试 代码 预期 运行 
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10.2.3 ”测试 异步 方法 
使 用 Mocha 测试 异步 方法 非常 简单 ， 在 完成 一 个 异步 方法 的 测试 之 后 调用 一 个 
即 可 。 例 如 ， 将 index.js 文件 中 的 方法 修改 为 一 个 异步 方法 : 


function async(callback){ 
setTimeout (function() { 
console.log('async'); 
callback (); 
}, 100) 


module.exports ={ 
async: async 
}; 


将 testjs 文件 内 容 修改 为 对 异步 方法 的 测试 ， 代 码 如 下 : 
/* 引 入 需要 测试 的 模块 */ 


var lib = require('./index'); 


/* 引 入 断言 模块 */ 


Var assert = require('assert'); 


/* 测 试 描述 */ 
describe('Async', function() { 
describe('#setTimeout ()', function(){ 
it('should wait 1l00ms', function(done) { 
lib.async (done); 
} 
} 
1D); 








互 


调 函数 








运行 mocha testjs -c 命令 ， 可 以 看 到 这 个 异步 方法 通过 了 测试 ， 如 图 10.11 所 示 。 





图 10.11 测试 异步 方法 


10.2.4 路 由 测试 
在 开发 中 往往 需要 对 后 端的 API 接口 进行 测试 ，Mocha 本 身 并 没有 集成 对 路 
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API 的 测 





第 10 章 ”Node.js 单元 测试 


试 支持 ， 此 时 需要 借助 supertest 这 个 库 进行 测试 。 当 然 ， 使 用 supertest 时 需要 先 使 用 NPM 进 
行 安装 : 


supertest 支持 各 个 框架 。 这 里 以 Express 为 例 , 通过 NPM 安装 完 Express 后 新 建 一 个 名 为 
appjs 的 文件 ， 写 入 以 下 内 容 : 





这 里 通过 Express 设 定 了 一 个 返回 json 格式 的 /user 路 由 , 通过 一 个 get 请 求 就 可 以 获取 用 
户 的 姓名 和 密码 ， 这 在 实际 开发 中 是 非常 常见 的 情景 。 
将 testjs 的 文件 修改 为 使 用 supertest 测试 的 内 容 ， 代 码 如 下 : 





通过 mocha 测试 之 后 可 以 发 现 测试 通过 ， 如 图 10.12 所 示 。 





10.12 API 测试 通过 
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当 测试 没有 通过 之 后 supertest 同样 会 在 命令 行 中 提示 用 户 。 例 如 ， 将 上 文中 测试 内 容 的 
返回 值 username 修改 为 name， 可 以 发 现 命令 行将 会 出 现 相 应 的 提示 ， 如 图 10.13 所 示 。 


x 








图 10.13 API 测试 不 通过 


10.2.5 ”测试 覆盖 率 


在 进行 单元 测试 的 时 候 ,我 们 还 需要 关注 测试 时 的 代码 覆盖 率 。 覆 盖 率 一 般 包 含 行 覆 盖 率 、 
函数 覆盖 率 、 分 支 覆盖 率 、 语 句 覆 盖 率 四 个 维度 。 在 Node.js 中 可 以 使 用 Istanbul 这 个 工具 作 
为 代码 履 盖 率 工具 ， 使 用 Istanbul 之 前 同样 需要 使 用 NPM 进行 安装 : 


npm install -g istanbul 
对 某 个 文件 进行 测试 时 ， 直 接 使 用 istanbul cover 命令 即 可 ， 如 文件 为 index.js: 
istanbul cover index.js 


运行 完成 之 后 可 以 看 到 命令 行 中 已 经 显示 了 相应 的 覆盖 率 ， 如 图 10.14 所 示 。 


: 100% 《070 





图 10.14 ”代码 覆盖 率 结果 
这 里 的 覆盖 率 报 告 对 应 的 分 pi 、 分 支 覆 盖 率 、 函 数 覆 盖 率 、 行 覆盖 率 。 从 这 


里 可 以 看 到 测试 覆盖 率 的 相应 结 
在 测试 的 时 候 ， 同 时 结合 mocha a 和 istanbul 就 可 以 实现 代码 的 全 面 测试 。 实现 起 来 非常 简 


单 ， 使 用 以 下 命令 即 可 : 
istanbul cover mocha 

运行 完 这 段 命令 之 后 可 以 在 命令 行 中 同时 进行 mocha 的 测试 和 代码 覆盖 率 ， 如 图 10.15 
所 示 。 
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图 10.15 ”代码 测试 与 覆盖 率 结果 

这 条 命令 同时 生成 了 一 个 名 为 coverage 的 子 文件 夹 。 在 这 个 文件 夹 下 的 coverage.json 文 
件 包含 了 覆盖 率 的 原始 数据 , 同时 在 这 个 文件 夹 下 的 lcov-report 文件 夹 下 的 文件 是 可 以 在 浏览 
器 中 打开 的 覆盖 率 报告 。 履 盖 率 报告 包含 详细 的 说 明 ， 如 图 10.16 所 示 。 








100% Stale 12 100% je 100% $5 100% 12/12 
File ^ Statements Branches Functions Lines 

Source/ ENN 100% | 12/12 100% -0/0 100% | 5/5 100% 12/12 
81.25% 13/16 50% 1/2 83.33% 5/6 81.25% 13/16 

File ^ Statements Branches Functions Lines 

source/ IE 8125% | 13/16 50% | 1/2 83.33% | 5/6 | 81.25% | 13/16 


图 10.16 覆盖 率 报告 


10.2.6 ”使 用 Travis-cli 


Travis-cli 是 一 个 在 线 的 、 分 布 式 的 持续 集成 服务 ， 可 以 用 来 构建 和 测试 在 GitHub 上 托管 
的 代码 ， 在 项 目的 自动 测试 中 非常 有 用 。 使 用 Travis-cli 时 ， 首 先 需要 在 Travis-cli 官方 网 站 使 
用 GitHub 登录 。Travis-cli 官方 网 站 的 网 址 是 https://travis-ci.org/， 如 图 10.17 所 示 。 


189 


Nodejs 开 发 实战 


Test and Deploy with Confidence 


green-eggs/ham © = 


CE 


0 





图 10.17 ”Travis-cli 官方 网 站 
使 用 GitHub 账号 登录 之 后 ， 就 可 以 选择 需要 打开 Travis-cli 的 GitHub 仓库 。Travis-cli 会 
把 项 目 默 认 当 作 Ruby 项 目 ， 因 此 Node.js 项 目 需要 在 根 目 录 下 加 入 .travis.yml 文件 ， 并 通过 这 
个 文件 来 对 项 目 进行 描述 : 
language: node js 


node js: 
CR Fh rdsy 


配置 完 .travis.yml 文件 以 后 ， 在 每 次 提交 的 时 候 就 可 以 进行 自动 构建 了 。 





温 故 知 新 


学 完 本 章 后 ， 读 者 需要 回答 : 


1. 单元 测试 的 意义 。 
2. Node.js 单元 测试 的 简单 使 用 。 
3. Mocha 的 简单 使 用 。 
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< 县 他 以 用 部 署 相 关 > 


Nodejs 的 知识 在 前 面 基本 已 经 介绍 完毕 ， 本 章 将 介绍 Nodejs 有 关 的 其 他 内 容 ， 包 括 与 


Node.js 应 用 部 署 有 关 的 Nginx 与 PM2， 以 及 Facebook 新 推出 的 包 管 理 器 Yarn。 
通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 
@ Nginx 的 简单 配置 和 使 用 。 
@ PM2 模块 守护 进程 的 使 用 。 
@ Yarn 作为 新 一 代 包 管理 器 的 优势 以 及 使 用 。 


使 用 Nginx 


Nginx 是 一 个 开源 、 高 效 、 高 性 能 的 HTTP 和 反 向 代理 服务 器 。Nginx 是 由 一 位 俄罗斯 的 






程序 员 设 计 开 发 的 ， 并 且 源 代码 以 BSD 许可 证 形式 发 布 。Nginx 凭借 高 稳定 性 、 
集 、 示 例 配 置 文件 和 低 系 统 资源 
替代 品 ， 目 前 国内 的 大 型 互联 网 公司 都 部 署 了 Nginx， 如 腾讯 、 新 浪 、 网 易 、 阿 里 





Nginx 可 以 作为 负载 均衡 服务 器 。Nginx 既 可 以 在 内 部 直接 支持 Rails 和 PHP 程序 


务 ， 也 可 以 作为 HTTP 代理 服务 器 对 外 进行 服务 。Nginx 采用 C 语言 编写 ， 不 论 是 系统 

是 CPU 使 用 效率 都 要 比 Perlbal 好 得 多 。 同 时 ，Nginx 也 是 一 款 非常 优秀 的 邮件 代理 服 
Nginx 的 官方 网 站 地 址 为 http://nginx.org/， 界 面 如 图 11.1 所 示 。 
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图 11.1 Nginx 官方 网 站 


丰富 的 功能 
的 消耗 而 闻名 ,在 高 连接 并 发 的 情况 下 , Nginx 是 不 错 的 Apache 





台电 入 

对 外 进行 服 
资源 开销 还 
务 器 。 


Nginx 支持 各 大 操作 系统 ， 下 面 介绍 其 安装 方法 。 
11.1.1 Linux 下 安装 Nginx 


在 Linux 下 安装 Nginx 需要 注意 的 是 , 在 下 载 安装 前 要 下 载 和 安装 相应 的 编译 工具 和 库 文件 。 
(1) 安装 编译 工具 和 库 文件 : 


(2) 下 载 PCRE library 库 : 


(3) 解压 : 


(4) 安装 : 





5% 下 载 Nginx: 


(6) 安装 Nginx: 





(7) 进入 相应 的 目录 执行 Nginx 可 执行 文件 。 


11.1.2 Windows 下 安装 Nginx 

在 Windows 下 只 需要 下 载 解压 即 可 使 用 ， 下 载 地址 为 http://nginx.org/en/download.html。 
运行 nginx.exe 即 可 启动 服务 ， 在 浏览 器 中 打开 可 看 到 如 图 11.2 所 示 的 画面 ， 说 明 Nginx 已 经 
运行 起 来 了 。 





Welcome to nginx! 


If you see this page, the nginx web server is successfully installed and 
‘working. Further configuration is required. 


For online documentation and support please refer to nginx.org. 
Commercial support is available at nginx.com. 


Thank you for using ngine. 





图 11.2 Nginx 运行 成 功 画面 
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11.1.3 ”Nginx 的 配置 


要 运行 网 站 ， 还 需要 对 Nginx 做 一 些 配置 。 在 nginx 文件 夹 的 conf 子 文件 夹 下 的 
nginx.config 文件 就 是 Nginx 的 配置 文件 ， 内 容 如 下 : 





Node.js 开发 实战 有 


























# 符 号 代表 注释 。 下 面 给 出 这 些 配 置 的 一 些 说 明 ， 参 照 这 些 说 明 即 可 部 署 好 静态 资源 : 
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Node.js 开发 3 





11.1.4 使 用 Nginx 部 署 网 站 


假设 我 们 现在 有 一 个 运行 在 3000 端口 的 Node.js 应 用 ， 可 以 利用 Nginx 作为 反 向 代理 ， 
并 且 将 静态 资源 交 由 Nginx 来 处 理 ， 这 样 对 外 表现 的 就 是 这 个 Node.js 应 用 运行 在 80 端口 。 
在 Nginx 中 添加 一 个 server 类 ， 内 容 如 下 : 
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当然 ,在 实际 开发 生产 中 , 为 了 最 大 化 地 利用 域名 ， 有 时 需要 更 多 地 使 用 二 级 域名 ， 以 运 
行 更 多 的 应 用 ， 同 样 只 要 添加 一 个 类 即 可 : 





这 样 在 浏览 器 中 输入 不 同 的 地 址 就 访问 了 不 同 的 应 用 ， 如 图 11.3 所 示 。 
EIU EE a 





忽 如 寄 的 个 人 站 点 


11.3 配置 多 个 域名 的 结果 
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忽 如 寄 入 | 个 人 博客 


LE Smee umm! “上 


Welcome to nginx! 


Thos thle peoes oe ne web me ee eh te en 
‘working. Further configuration is required. 


For online documentation and support please refer to nginx.org. 
Commercial support is available at nginx.com. 


Thank you for using nginx. 





图 11.3 配置 多 个 域名 的 结果 〈 续 ) 


这 里 说 明 一 下 ， 利 用 二 级 域名 是 一 种 充分 利用 域名 资源 的 方法 。 同 样 ， 也 可 以 利用 路 径 ， 
这 和 服务 器 内 部 采用 的 映射 方式 有 关 。Nginx 就 不 能 根据 路 径 ， 但 是 可 以 使 用 二 级 域名 使 不 同 
应 用 运行 在 同一 个 一 级 域名 下 。IIS 则 可 以 利用 路 径 来 对 外 表现 不 同 的 应 用 。 


11.2 Yarn 一 一 新 的 包 管 理工 具 


2016 年 Facebook 发 布 了 一 款 包 管理 器 一 一 Yarn， 希 望 可 以 成 为 一 个 替代 NPM 的 快速 、 
可 靠 和 安全 的 包 管理 器 。Yarn 作为 一 个 JavaScript 软件 包 管理 器 ， 主 要 有 以 下 几 个 功能 : 


离线 模式 : 只 要 用 户 已 经 下 载 过 的 包 ， 即 使 离线 也 可 以 再 次 安装 。 

网 络 恢复 : 下 载 软件 包 失败 后 会 自动 重新 请 求 ， 这 样 就 可 以 避免 整个 安装 过 程 失败 。 
多 个 注册 表 : 既 能 从 NPM 或 Bower 安装 任何 包 ， 也 能 保证 各 平台 依赖 的 一 致 性 。 

网 络 性 能 : Yarn 会 对 请 求 进行 高 效 的 排队 ， 避 免 出 现 请 求 瀑布 (waterfall ) , 便于 将 
网 络 的 使 用 效率 达到 最 大 化 。 

扁平 化 模式 : 将 不 匹配 的 依赖 版 本 解析 为 同一 个 版 本 ， 避 免 重 复 创建 。 

确定 性 : 不 管 安装 顺序 如 何 ， 相 同 的 依赖 在 每 台 机 器 上 都 会 以 完全 相同 的 方式 进 


Yar 的 GitHub 地 址 为 https:/github.com/yarnpkg/yarn， 富 方 网 址 为 https://yarnpkg.com/。 
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同时 ， 在 官方 网 址 上 可 选择 对 应 的 中 文 版 ， 对 于 国内 的 开发 者 来 说 还 是 相对 便捷 的 。Yarmn 的 
官方 网 站 如 图 11.4 所 示 。 


pn ee 日 se 二 9 交 -日 入 上 0 


快速 、 可 靠 、 安 全 的 依赖 管理 。 


立刻 开始 ! 安装 YARN | © star | 25.583 | 


稳定 版 v0.24.6 ,候选 发 布 皮 不 v0.25.4 





11.4 Yarn 官方 网 站 
Yarn 的 安装 非常 便捷 ， 官 方 提供 了 macOS、Windows、Linux 这 三 种 操作 系统 的 详细 安装 


(1) 利用 .msi 文件 安装 时 ， 直 接 下 载 单 击 安装 即 可 。 不 过 ， 在 这 之 前 用 户 应 该 确保 已 经 
安装 了 Nodejs。 
(2) 利用 Chocolatey 安装 时 ， 执 行 以 下 命令 安装 即 可 : 


choco install yarn 
这 个 命令 将 确保 用 户 安装 Nodejs。 
(3) 利用 Scoop 安装 时 , 使 用 以 下 命令 即 可 , 不 过 在 这 之 前 也 要 确保 已 经 安装 了 Nodejs: 
有 i 
Yarn 安装 完成 后 可 以 使 用 yarn--version 命令 来 查看 Yarn 的 版 本 ， 如 图 11.5 所 示 。 


图 11.5 查看 Yam 版 本 


Yarn 的 使 用 非常 简单 ， 当 开发 者 开始 一 个 新 项 目 时 ， 类 似 于 npm， 只 需要 使 用 yarn init 
命令 并 且 填 写 部 分 项 目 信 息 即 可 生成 一 个 packagejson 文件 ， 如 图 11.6 所 示 。 


yarn --version 


yarn init 
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图 11.6 yam init 命令 需要 填写 的 信息 


-个 典型 的 通过 yarn init 命令 生成 的 package.json 文件 内 容 大 致 如 下 : 


bd 于 计 工 9 
人 
"main": "main.js", 
"license": "MIT", 


"dependencies": {} 


Yarn 安装 、 升 级 、 移 除 依赖 包 分 别 使 用 add、upgrade、remove 命令 关键 字 。 例 如 ， 安 装 、 
升级 、 移 除 Koa 框架 的 命令 为 : 
yarn add koa 
yarn upgrade koa 
yarn remove koa 

在 安装 和 升级 相关 依赖 包 的 时 候 可 以 在 依赖 包 后 指定 安装 和 升级 到 对 应 的 版 本 , 只 需要 使 
用 @ 符 号 即 可 : 
yarn add package@versioin 
yarn upgrade package@version 

在 初次 安装 依赖 包 的 时 候 会 生成 一 个 yarn.lock 文件 。 这 个 文件 的 作用 是 通过 保存 那些 依 
赖 版 本 和 包 一 起 安装 来 确保 包 跨 平台 安装 时 是 一 致 的 ， 也 就 是 上 文中 提 到 的 确定 性 。 

类 似 于 npm，Yarn 同样 也 支持 一 次 性 安装 package.json 文件 中 的 所 有 依赖 包 。 使 用 yarn 
install 命令 即 可 完成 这 项 任务 : 


yarn install 


这 个 命令 还 有 很 多 选项 ， 如 安装 一 个 包 的 单一 版 本 时 添加 -flat 选项 、 强 制 重新 下 载 使 用 
-force 选项 、 只 安装 生产 环境 依赖 则 使 用 --production 选项 : 
yarn install -flat 


yarn install -force 
yarn install --production 


Yarn 的 使 用 大 致 如 此 ， 如 果 读 者 需要 获取 更 多 关于 Yam 的 知识 ,请 阅读 官方 网 站 的 详细 
指南 和 文档 。 
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我 们 知道 在 开发 中 一 个 进程 会 在 用 户 退出 终端 之 后 直接 关闭 , 这 个 进程 也 就 会 被 关闭 , 而 

-个 Nodejs 应 用 常常 会 因为 一 个 错误 而 导致 进程 终止 ， 导 致 Nodejs 服务 也 随 之 关闭 。 因 此 

在 线 上 部 署 应 用 的 时 候 有 必要 使 Node.js 应 用 以 守护 进程 的 方式 来 启动 .x PM2 正 是 这 样 的 一 款 
Nodejs 应 用 进程 管理 器 。 

PM2 的 GitHub 地 址 是 https://github.com/Unitech/pm2, 官方 网 站 为 http://pm2.keymetrics.io/。 


使 用 Nodejs 之 前 需要 使 用 NPM 来 安装 PM2: 





npm install pm2 -g 
使 用 PM2 开启 一 个 进程 非常 简单 ， 只 需要 使 用 以 下 命令 即 可 : 
Ppm2 start app.js 


其 中 ，appjs 为 将 要 以 守护 进程 方式 启动 的 node.js 应 用 文件 。 
类 似 于 其 他 的 模块 ， 使 用 -h 命令 可 以 看 到 PM2 的 所 有 命令 ， 如 图 11.7 所 示 。 


pm2 -h 





图 11.7 PM2 的 命令 提示 
当 PM2 开启 了 大 量 的 Node.js 应 用 时 ， 可 以 使 用 list 命 令 列 出 当前 运行 的 所 有 应 用 ， 如 图 
11.8 所 示 。 





pm2 list 


ie: Wsers\Adninistrator \Desktop>pn2 




















11.8 ”PM2 列 出 应 

















需要 提醒 的 是 ， 图 11.8 中 的 数字 代表 Node.js 应 用 的 id 号 ， 当 需要 停止 Node.js 应 用 的 时 
只 需要 使 用 id 即 可 : 
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all 关键 字 代表 当前 运行 的 所 有 进程 ， 也 可 以 使 用 这 个 方法 停止 所 有 的 Node:js 应 用 : 


一 个 Nodejs 运行 之 后 会 占用 越 来 越 多 的 内 存 ， 这 时 需要 重启 Nodejs 应 用 。PM2 提供 了 
restart 命令 来 重新 启动 一 个 Nodejs 应 用 。 
重启 一 个 Nodejs 应 用 : 


重启 所 有 的 Node.js 应 用 : 


1 1 .4 使 用 Koa 


Koa 框 架 是 由 Express 框架 的 原 班 人 马 打造 而 成 的 .这 个 Web 框架 的 目标 是 成 为 一 个 更 小 、 
更 富 表现 力 、 更 健壮 的 Web 框架 。Koa 框架 解决 的 主要 问题 是 大 量 的 回调 函数 嵌 套 ， 也 就 是 
常 说 的 “回调 地 狱 ”， 而 且 Koa 不 在 内 核 中 绑 定 任何 中 间 件 ， 提 供 的 仅仅 是 一 个 函数 库 ， 这 
让 Web 开发 更 加 轻快 。Koa 是 一 个 面向 未 来 的 框架 。 

Koa 框架 官方 网 站 的 地 址 是 htp:/koajscom/， 相 应 的 GitHub 地 址 为 https://github.com/koajs/koa。 

使 用 Koa 框架 之 前 同样 需要 通过 NPM 安装 : 


完成 安装 之 后 就 可 以 在 项 目 中 使 用 了 。 
一 个 简单 的 Koa 应 用 程序 可 能 如 下 : 





启动 这 个 应 用 ， 就 可 以 在 本 地 的 3000 端口 看 到 一 个 简单 的 Web 应用。 

Koa 应 用 得 益 于 大 量 的 中 间 件 ， 因 此 Koa 中 最 常用 的 方法 便 是 koa.use()〈 将 给 定 的 函数 
作为 中 间 件 加 载 ) 。 

Koa 将 req 和 res 对 象 封装 成 一 个 ctx 上 下 文 对 象 ， 可 以 通过 ctx.request 和 ctx.response 对 
象 访问 相应 的 方法 和 属性 ， 如 图 11.9 和 图 11.10 所 示 。 





图 11.9 ctx.request 








图 11.10 ctx.response 


在 Koa 中 ，ctx 上 下 文 对 象 的 主要 api 有 : 


ctx.req: Node.js 中 的 request 对 象 。 

ctx.res: Node.js 中 的 response 对 象 。 

ctx.app: app 实例 。 

ctx.state: 命名 空间 。 

ctx.cookies.get(name,[options]): 返回 相应 的 cookie。 
ctx.cookies.set(name,value,[options]): 设置 新 的 cookie。 相 应 的 option 参数 如 下 : 


signed: Boolean, 

expires: Date, 

path: String， 默 认为 '/'， 
domain: String, 

secure: Boolean, 

httpOnly: Boolean， 默 认为 true 


@ ctx.throw(msg, [status]): 抛 出 错误 的 辅助 方法 ， 默 认 status 为 500。 
@@ ctx.assert(value, [msg], [status], [properties]): 用 来 断言 的 辅助 方法 。 
Request 对 象 常用 的 API 有 : 

req.header: 返回 请 求 头 。 

req.method: 返回 请 求 方法 。 

req.method=: 设置 method。 

req.url: 返回 请 求 url。 

Ieq.url=: 设置 url。 


req.path: 返回 path。 


req.path=: 设置 path。 
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@ req.querystring: 返回 查询 字符 囊 ， 去 除 头 部 的 “? ”。 
@ req.ip: 返回 请 求 IP。 
@ req.ips: 返回 请 求 IP 列表 。 


Response 对 象 的 API 主要 有 : 


res.header: 获取 返回 头 。 

res.status: 获取 返回 的 HTTP 状态 码 。 
res.status=: 设置 状态 法 。 

Tes.length: 返回 content-length 属性 。 
res.length=: 设置 content-length。 

res.body: 获取 响应 体 。 

res.body=: 设置 响应 体 。 

res.get(field): 获取 相应 的 返回 头 属性 。 
res.set(field, value): 设置 相应 的 属性 值 。 
set.set(fields): 一 次 设置 多 个 ， 参 数 为 对 象 。 
res.remove(fields): 删除 指定 的 返回 头 属性 。 
res.type: 获取 返回 的 content-type。 
res.type=: 设置 content-type。 
res.redirect(url,[alt]): 重 定向 ， 可 以 使 用 关键 字 back 返回 上 一 个 页 面 (refer) ， 没 有 
refer 时 ， 返 回 “/”。 


更 多 关于 Koa 框架 的 应 用 可 以 通过 相应 的 书籍 进行 学 习 和 查阅 。 


补 四 访 
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本 篇 3 


要 介绍 3 个 项 目 案例 的 开发 过 程 ， 主 要 包括 个 人 博客 系统 、 任 务 清单 、NPM 包 ， 


涉及 Express、Meteor、NPM 包 的 开发 和 发 布 ， 以 及 需求 分 析 、 数 据 库 设 计 、 业 务 层 设计 和 表 
示 层 设计 的 详细 过 程 。 


第 12 章 
使 用 Express 开 发 个 人 博 守 系统 


如 今 个 人 博客 越 来 越 普遍 。 越 来 越 多 的 技术 人 员 通 过 个 人 博客 来 和 外 界 交流 技术 和 提高 自 
己 。Express 是 如 今 较为 流行 和 稳定 的 Nodejs 框架 ， 甚 至 有 人 基于 Express 提出 了 MEAN 服 
务 端 架 构 。MySQL 则 是 传统 中 广 受 欢迎 的 开源 SQL 数据 库 。 本 章 将 通过 实际 编码 实现 一 个 由 
Express 和 MySQL 搭建 的 个 人 博客 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 
一 个 完整 项 目的 开发 流程 。 
Express 框架 的 实际 使 用 。 
Express 与 MySQL 数据 库 的 结合 使 用 。 
一 个 博客 项 目 实现 的 要 点 。 


项 目 准备 


12.1.1 项 目 概述 


博客 是 21 世纪 初 兴起 的 一 种 表达 个 人 思想 、 积 累 个 人 知识 、 与 他 人 交流 沟通 的 社会 媒体 。 
在 这 个 自 媒 体 日 渐 繁 荣 的 时 代 ， 博 客 成 为 自 媒体 中 不 可 忽视 的 力量 。 在 技术 人 员 中 ， 博 客 往往 
是 个 人 知识 积累 的 一 个 平台 ， 也 是 别人 了 解 自 己 的 途径 ， 可 以 说 每 一 个 技术 人 员 都 应 该 有 一 个 
自己 的 个 人 博客 。 

本 章 将 通过 一 个 简单 的 个 人 博客 系统 让 读者 了 解 和 掌握 一 个 项 目的 开发 。 在 本 章 中 , 我 们 
选择 的 框架 是 Express、 数 据 库 是 MySQL。 关 于 Express 和 MySQL 的 基础 知识 ， 读 者 可 以 通 
过 本 书 前 面 的 章节 或 者 其 他 相关 的 书籍 进行 了 解 和 掌握 。 

在 这 个 项 目 中 ， 网 站 访问 者 可 以 浏览 作者 发 布 的 文章 和 信息 ， 通 过 登录 即 可 发 布 、 修 改 、 
删除 文章 。 更 多 项 目的 细节 ， 读 者 可 以 访问 https://blog.huruji3.com/ 网 站 来 查看 和 体验 。 








12.1.2 前端 界面 设计 
个 人 博客 网 站 最 重要 的 就 是 内 容 ， 因 此 在 博客 网 站 的 首页 就 应 该 让 读者 了 解 到 作者 的 文 
章 ， 而 不 是 像 企业 网 站 那样 显示 大 量 有 关 企业 产品 的 介绍 。 博客 首页 的 主要 内 容 可 以 是 文章 的 
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标题 ， 让 读者 通过 标题 迅速 了 解 到 相关 的 领域 并 找到 自己 需要 的 内 容 。 

当然 ， 一 个 博客 网 站 还 需要 有 博 主 个 人 的 介绍 等 页 面 ， 因 此 同样 需要 用 一 个 navigation 来 
跳 转 到 各 个 页 面 。 因为 这 里 个 人 博客 网 的 链接 并 不 多 ， 所 以 通过 一 个 侧 边栏 来 实现 这 个 功能 是 
比较 合适 的 。 因 为 所 有 的 页 面 都 应 该 是 能 够 互相 跳 转 的 , 所 以 这 个 侧 边栏 应 该 是 每 个 页 面 都 需 
要 的 。 为 了 让 整个 博客 页 面 显得 更 加 完整 ， 为 每 一 个 页 面 添加 同样 的 header 和 footer 是 很 有 
必要 的 。 

可 以 大 致 将 整个 个 人 博客 项 目 分 为 首页 、 内 容 页 、 文 章 编辑 页 、 登 录 页 。 首 页 、 内 容 页 、 
文章 编辑 页 都 需要 侧 边栏 、header、footer。 登 录 页 用 一 个 简单 的 表单 实现 即 可 。 首 页 、 内 容 
页 、 文 章 编辑 页 大 致 可 以 设计 为 图 12.1、 图 12.2、 图 12.3 所 示 的 样子 。 











图 12.1 博客 首页 设计 稿 











122 博客 内 容 页 设计 稿 
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12.3 ”博客 文章 编辑 页 设计 稿 
博客 登录 页 面 是 一 个 简单 的 登录 表单 , 为 了 让 这 个 页 面 不 至 于 太 单调 , 可 以 选择 一 张 合 适 
的 图 片 作为 背景 。 登 录 页 的 设计 稿 如 图 12.4 所 示 。 


大 图 背景 


12.4 登录 页 设计 稿 
至 此 ， 整 个 项 目的 框架 设计 就 基本 完成 了 。 


12.1.3 ”数据库 设计 
如 上 文 所 述 , 个 人 博客 最 重要 的 是 内 容 , 也 就 是 文章 ， 因 此 个 人 博客 中 必 不 可 少 的 就 是 文 
章 数据 表 。 很 明显 ， 这 个 数据 表 中 必然 需要 的 字段 应 有 文章 标题 、 文 章 内 容 。 
为 了 方便 读者 了 解 作 者 发 表 文 章 的 信息 ， 可 以 添加 一 个 时 间 字 段 ， 显 示 文 章 发 布 的 时 间 。 
为 了 衡量 一 篇 文章 的 质量 , 添加 一 个 访问 量 字段 是 一 个 不 错 的 选择 : 读者 可 以 通过 这 个 字 
段 来 衡量 文章 的 质量 ， 作 者 则 可 以 通过 这 个 字段 来 判断 哪些 领域 的 文章 比较 受 欢 迎 
因为 在 这 个 项 目 中 需要 通过 登录 才能 发 布 文章 ,所 以 可 以 通过 一 个 作者 字段 来 说 明文 章 的 
发 布 者 。 如 果 博 客 是 由 多 人 或 者 一 个 团队 来 维护 的 ， 那 么 这 个 字段 是 非常 重要 的 。 因 此 ,文章 
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数据 表 可 以 设计 为 如 图 12.5 所 示 的 形式 。 





: 
i 
; 
上 





外 
六 
四 
各 


图 12.5 数据 库 文章 表 设计 


如 上 文 所 述 , 这 个 博客 项 目 是 需要 通过 登录 才能 发 布 文 章 的 , 所 以 整个 博客 是 可 以 由 多 人 
或 者 一 个 团队 来 维护 的 。 因 此， 需要 设计 一 个 作者 表 ， 包 含 作者 姓名 、 作 者 密码 等 字段 ， 如 图 


12.6 所 示 。 
作者 表 
Chinese Field Type Null Key Default Extra 
作者 ID authorlD int NO PRI auto_increment 
作者 姓名 authorName varchar NO UNI 
作者 密码 authorpassword varchar NO 


12.6 数据库 作 者 表 设 计 


此 时 ,个 人 博客 项 目的 数据 设计 已 经 完成 。 连接 MySQL 数据 库 之 后 在 命令 行 中 输入 以 下 
代码 即 可 在 MySQL 中 创建 项 目 所 需 的 数据 库 : 





2 人 2 
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12.2 项 目 开发 


12.2.1 快速 生成 一 个 项 目 


Express 项 目 可 以 通过 Express 项 目 生 成 器 快速 生成 。 当 然 ， 使 用 Express 项 目 生成 器 之 前 
需要 从 NPM 中 下 载 安 装 ， 可 使 用 以 下 命令 安装 Express 项 目 生 成 器 : 


安装 完成 后 使 用 以 下 命令 生成 一 个 使 用 ejs 模板 的 Express 博客 项 目 : 


此 时 会 在 使 用 该 命令 的 文件 夹 中 自动 创建 一 个 名 为 blog 的 文件 夹 ， 即 项 目 文件 夹 。blog 
文件 夹 的 项 目 目 录 如 图 12.7 所 示 。 





12.7 ”Express 项 目 目录 
在 这 个 项 目 目录 中 ，public 文件 夹 为 静态 资源 文件 夹 ，routes 文件 夹 为 路 由 文件 夹 ，views 
文件 夹 为 6js 模板 文件 夹 。 
此 时 并 没有 安装 项 目 依赖 ， 可 以 使 用 以 下 命令 安装 : 


接 下 来 看 一 看 appjs 文件 中 的 内 容 。 其 代码 及 相关 解释 如 下 : 
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在 本 项 目 中 ， 前 端 界面 是 通过 normalize.css 库 来 统一 各 个 浏览 器 默认 样式 的 。 可 以 通过 
NPM 安装 normalize: 


安装 完成 后 在 node_modules 文件 夹 中 找到 normalize.css 文件 夹 ， 将 normalize.css 文件 移 
动 到 public 文件 夹 中 的 css 文件 夹 下， 以 供 后 续 使 用 。 
同时 在 appjs 中 添加 以 下 代码 : 





这 样 通过 node app 命令 就 可 以 启动 项 目 了 。 


12.2.2 ”实现 登录 界面 


登录 界面 的 前 端 页 面 仅 仅 由 一 个 登录 表单 组 成 ,而 登录 的 核心 思想 就 是 利用 用 户 提交 的 用 
户 名 、 密 码 等 信息 与 后 端 数 据 库 中 的 信息 进行 对 比 , 根据 对 比 结果 给 用 户 反 馈 。 一 般 的 情形 就 
是 信息 匹配 一 致 ,将 用 户 界面 重 定向 至 用 户 需 要 进入 的 页 面 ; 信息 匹配 不 一 致 时 ， 则 将 错误 信 
息 反 馈 给 用 户 。 


(1) 首先 需要 实现 一 个 前 端 界面 ， 保 证 用 户 请 求 数据 时 这 个 页 面 是 可 用 的 。 
在 项 目 route 子 文件 夹 下 的 indexjs 中 写 入 如 下 内 容 : 


这 里 使 用 到 Express 的 方法 有 : 


@ get0: 定义 一 个 请 求 方法 为 get 方法 的 路 由 ， 第 一 个 参数 是 请 求 的 url 路 径 
@ res.render(): 泻 染 一 个 视图 模板 ， 第 一 个 参数 是 模板 引擎 文件 夹 下 的 视图 文件 名 ， 第 
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二 个 参数 是 传 给 视图 的 json 数据 。 
(2) 接 下 来 重 构 这 个 登录 页 面 ， 在 views 文件 夹 下 新 建 一 个 login.ejs 文件 ， 写 入 以 下 内 容 : 


(3) 对 这 个 页 面 进行 样式 开发 。 在 public 文件 夹 中 的 css 文件 夹 下 新 建 一 个 main.css 文 
件 ， 作 为 整个 项 目的 样式 文件 。 在 这 个 文件 开头 先 写 入 项 目的 公共 样式 ， 代 码 如 下 : 
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(4) 接着 写 入 以 下 代码 作为 登录 界面 的 样式 : 
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} 

.login footert{ 
position:absolute; 
bottom:20px; 
display: block; 
width:100%; 


(5) 在 login.ejs 文件 中 引入 main.css。 在 login.ejs 的 head 标签 下 添加 以 下 内 容 : 
<link rel="stylesheet" href="/css/normalize.css"> 
<link rel="stylesheet" href="/css/main.css"> 

启动 项 目 ， 在 浏览 器 地 址 栏 中 输入 localhost:3000/login 后 可 以 看 到 登录 界面 ， 如 图 12.8 
所 示 。 





图 12.8 ”登录 界面 


这 时 , 项 目 已 经 可 以 根据 用 户 请 求 登录 页 面 正常 返回 了 。 接 下 来 开发 登录 的 核心 , 就 是 通 
过 用 户 提 交 的 信息 与 数据 库 中 的 信息 进行 比较 , 从 而 得 出 结果 。 在 项 目的 根 目 录 中 新 建 一 个 名 
为 config.js 的 文件 ， 作 为 项 目的 配置 文件 。 这 里 仅仅 需要 做 一 下 数据 库 的 配置 ， 可 在 configjs 
文件 中 写 入 以 下 代码 : 
/* 数 据 库 相 应 信息 */ 
const DB = { 

host:"localhost", 

port:3306, 

user:"root", 

password: "password", 

database:"blog" 
] 7 
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同时 在 根 目录 文件 中 新 建 一 个 名 为 database.js 的 文件 ， 作 为 mysql 连接 的 文件 。 在 这 个 文 
件 中 写 入 以 下 内 容 : 





这 时 我 们 的 博客 项 目 已 经 连接 好 了 MySQL， 接 下 来 就 是 在 用 户 提交 数据 的 时 候 与 数据 库 
中 的 数据 进行 对 比 了 。 在 login.ejs 中 已 经 定义 了 登录 名 和 密码 的 name， 以 及 这 个 登录 表单 提 
交 的 路 径 (/login) 和 提交 方法 (POST) 。 

如 前 文 数 据 库 设 计 中 所 述 ， 用 户 的 密码 是 通过 md5 加 密 后 存储 在 MySQL 中 的 ， 所 以 用 
户 提交 的 数据 同样 需要 通过 md5 加 密 后 才能 对 比 ， 因 此 需要 引入 crypto 模块 。 在 route 文件 夹 
下 的 index.js 中 引入 crypto 和 database.js 模块 : 





将 用 户 数 据 与 数据 库 信息 对 比 ， 需 要 在 route 文件 夹 下 的 indexjs 中 写 入 以 下 内 容 : 
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这 里 使 用 到 的 重要 方法 是 mysql.escape 0， 可 防止 SQL 注入 攻击 , 对 用 户 提交 的 数据 进行 
处 理 。 


此 时 ， 启 动 项 目 ， 在 浏览 器 中 输入 localhost:3000/login 后 显示 登录 页面， 再 输入 数据 库 中 
预先 设置 好 的 用 户 名 (node) 以 及 密码 (123456) ， 页 面 就 会 自动 跳 转 到 首页 ， 如 图 12.9 所 
示 。 


Express 


Welcome to Express 


图 12.9 跳 转 至 首页 


这 时 登录 的 功能 虽然 已 经 实现 , 但 是 当 输 入 密码 和 用 户 名 后 , 浏览 器 没有 任何 反应 ,对 用 
户 来 说 显然 是 非常 不 友好 的 。 因 此 需要 增加 对 密码 或 者 用 户 名 输入 错误 的 处 理 。 在 这 里 ， 需 要 
在 用 户 名 或 者 密码 错误 时 给 用 户 提醒 。 修 改 登录 的 post 方法 请 求 的 处 理 。 代 码 如 下 : 
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} 

var user = rows[0]; 

if(!user) { 
res.render('login'， {message:' 用 户 名 或 者 密码 错误 ' }); 
return; 

} 

req.session.userSign = true; 

req.session.userID = user.authorID; 
res.redirect ('/'); 

]) 7 
1D); 


在 login.ejs 文件 中 增加 错误 信息 的 显示 。 修 改 密码 的 div 元 素 为 以 下 内 容 : 
<div class="form-group"> 
<input type="password" name="password" placeholder=" 密 码 "> 
<%if(message) {%> 
<p> <%= message%> </p> 
<% } $%> 
</div> 
因为 密码 或 者 用 户 名 错误 时 泻 染 的 模板 和 get 请 求 泻 染 的 模板 是 同一 个 模板 , 所 以 也 需要 
给 get 请 求 添加 一 个 json 数据 ， 将 get 请 求 的 处 理 函 数 改 为 如 下 内 容 : 
router.get('/login', function(req, res, next) { 
res.render('login', {message:''}); 
1); 
重新 启动 项 目 ， 可 以 发 现 当 密码 或 者 用 户 名 错误 时 ， 己 经 有 了 对 用 户 友 好 的 提醒 ， 如 图 
12.10 所 示 。 








图 12.10 提示 用 户 名 或 者 密码 错误 
博客 项 目的 登录 页 面 就 完成 了 。 
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12.2.3 ”实现 博客 首页 界面 

上 文中 登录 博客 后 自动 跳 转 至 首页 , 接 下 来 实现 博客 的 首页 。 博客 首页 是 任何 用 户 都 可 以 
访问 的 ， 所 以 不 需要 做 权限 设置 。 

在 route 文件 夹 下 的 indexjs 文件 中 将 首页 的 get 请 求 处 理 改 为 如 下 代码 : 


在 views 文件 夹 下 的 index.ejs 文件 中 写 入 以 下 代码 : 
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此 时 ， 首 页 基本 可 以 看 了 。 为 了 用 户 体验 更 好 ， 接 下 来 要 进行 样式 的 开发 。 
在 main.css 文件 中 继续 写 入 以 下 内 容 : 
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margin:0; 

font-weight: normal; 

font-size: 24px; 

line-height: 40px; 
.main-articles-items-des spant{ 

padding-right:8px; 

color:#333; 

font-size: 14px; 


重新 启动 项 目 ， 在 浏览 器 中 可 以 看 到 首页 的 效果 ， 如 图 12.11 所 示 。 
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图 12.11 博客 首页 界面 


此 时 数据 库 中 并 没有 文章 , 因此 博客 的 首页 也 就 没有 任何 文章 显示 。 
添加 几 条 记录 来 验证 一 下 效果 。 连 接 好 MySQL 后 在 全 加 


向 MySQL 数据 库 中 手动 
下 命令 ， 向 MySQL 中 添 








加 几 篇 文章 : 


INSERT article SET articleTitle="Node.js 基础 知识 
",articleAuthor="node",articleContent="Node.j 
基础 知识 简要 介绍 ", articleTime=CURDATE () ; 


INSERT article SET articleTitle="Node.js 进 阶 知识 


"varticleAuthor="node"varticleCcontent="Node.js 进 阶 知识 简要 介绍 


",articleTime=CURDATE () 7 


INSERT article SET articleTitle="Node.js 高 级 知识 


",articleAuthor="node",articleContent="Node.js 高 级 知识 简要 介绍 


"varticleTime=CURDRTE () 7 


命令 
中 


行 
输 


直接 
入 以 


这 时 , 刷新 浏览 器 可 以 看 到 三 篇 文章 的 标题 已 经 出 现在 了 项 目 首页 界面 , 如 图 12.12 所 示 。 
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图 12.12 带 有 数据 的 博客 首页 
这 时 ， 首 页 文章 的 发 布 时 间 是 国际 时 间 ， 既 在 排版 上 影响 了 整个 页 面 的 美观 ， 也 不 利于 辩 
识 时 间 ， 因 此 需要 在 传递 给 视图 之 前 将 这 个 时 间 处 理 一 下 ,将 首页 的 get 请 求 处 理 修改 为 以 下 
代码 : 


router.get('/', functionl(req, res, next) { 
Var query = 'SELECT * FROM article'; 
mysql.query (query, functionl(err, rows, fields){ 
var articles = rows; 
articles.forEach (function(ele) { 
Var year = ele.articleTime.getFullYear(); 
Var month = ele.articleTime.getMonth() + 1 > 10 ? 
ele.articleTime.getMonth() : '0' + (ele.articleTime.getMonth() + 1) 
Var date = ele.articleTime.getDate() > 10 ? ele.articleTime.getDate() : 
'0' + ele.articleTime.getDate(); 
ele.articleTime = year + '-' + month + '-' + date; 
1D); 
res.render ("index", {articles: articles}); 
]) 7 
]) 





i 启动 项 目 ， 可 以 在 浏览 器 中 看 到 文章 的 时 间 已 经 符合 预期 了 ， 如 图 12.13 所 示 。 
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图 12.13 时间 格式 修改 后 的 博客 首页 
这 时 给 鼠标 移入 文章 添加 一 些 简单 的 动 效 , 优化 一 下 用 户 体验 , 在 main.css 中 添加 以 下 代 
码 : 
@keyframes move { 
from{ 
transform:translate (Opx, 0); 
} 


to{ 
transform:translate (50px, 0); 


} 

.main-articles-item:hover{ 
animation:move 1.8s; 
animation-fill-mode: forwards; 


这 时 可 以 发 现 ， 整 个 项 目的 前 端 页 面 有 非常 多 可 以 重用 的 地 方 ， 比 如 网 页 的 头 部 和 尾部 ， 
几乎 每 个 页 面 都 会 用 到 ， 前 端 页 面 的 head 标签 内 容 也 是 完全 一 致 的 ， 这 些 内 容 在 之 后 的 博客 
页 面 依旧 会 用 到 ， 因 此 可 以 将 这 些 东 西 分 离 出 来 重用 。 

在 views 文件 夹 下 新 建 一 个 名 为 public 的 文件 夹 ， 在 这 个 文件 夹 中 分 别 新 建 head.ejs、 
header.ejs、footer.ejs、aside.ejs 文件 ， 在 head.ejs 中 写 入 head 标签 的 内 容 ， 即 将 以 下 代码 写 入 
这 个 文件 : 

















<head> 
<meta charset="UTF-8"> 
<title>Node 的 个 人 博客 </title> 
<meta http-equiv="X-UA-Compatible" content="IE=Edge,chrome=1"> 
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在 header.ejs 文件 中 写 入 博客 网 站 的 头 部 ， 即 将 以 下 代码 写 入 header.ejs 文件 : 





在 footer.ejs 文件 中 写 入 博客 网 站 的 尾部 ， 即 将 以 下 代码 写 入 footer.ejs 文件 : 





在 aside.ejs 文件 中 写 入 博客 网 站 的 侧 边 栏 ， 即 将 以 下 代码 写 入 aside.ejs 文件 : 





利用 ejs 的 include 方法 可 以 将 外 部 的 ejs 文件 引入 ， 引 入 的 方法 如 下 : 


因此 , 可 以 通过 这 种 方式 将 这 些 文件 引入 login.ejs 文件 和 index.ejs 文件 ,修改 后 的 login.ejs 
文件 内 容 如 下 : 





229 


Node.js 开发 实战 0 


修改 后 的 index.ejs 文件 内 容 如 下 : 
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12.2.4 博客 文章 内 容 页 的 实现 


每 篇 文章 都 有 一 个 内 容 页 ， 当 一 个 博客 的 文章 量 很 大 时 , 不 可 能 单独 为 每 篇 文章 的 内 容 都 
单独 设计 一 个 路 由 。Express 提供 了 一 种 路 由 配置 方式 ， 在 路 由 路 径 中 使 用 一 个 占 位 符 ， 通 过 
这 个 占 位 符 来 判断 不 同 的 路 由 。 这 个 博客 项 目 中 ， 每 篇 文章 的 ID 是 不 同 的 ， 因 此 很 适合 作为 
占 位 符 ， 在 route 文件 夹 下 的 index.js 文件 中 添加 以 下 代码 : 





这 里 使 用 到 重要 的 方法 有 req.params。 这 个 对 象 存储 着 请 求 时 路 由 配置 中 占 位 符 的 真实 内 
容 ， 占 位 符 使 用 : 开头 表示 ， 这 里 使 用 的 是 每 篇 文章 的 ID。 

文章 内 容 的 路 由 配置 完成 ， 接 下 来 就 是 视图 模板 的 开发 了 。 在 views 文件 夹 下 新 建 一 个 名 
为 article.ejs 的 文件 ， 在 这 个 文件 中 写 入 以 下 代码 : 
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接 下 来 需要 为 文章 内 容 页 添加 样式 ， 在 main.css 文件 中 继续 写 入 以 下 代码 : 


此 时 , 重新 启动 项 目 , 在 浏览 器 中 输入 第 一 篇 文章 内 容 页 的 URL, 即 localhost:3000/articles/1， 
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可 以 看 到 内 容 页 已 经 出 现在 浏览 器 中 了 ， 如 图 12.14 所 示 。 
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图 12.14 文章 内 容 页 
此 时 ， 文 章 内 容 页 已 经 可 以 通过 URL 访问 了 。 当 然 ， 对 于 一 个 整体 来 说 ， 还 需要 在 首页 
中 添加 文章 的 URL， 以 方便 访问 者 通过 首页 的 点 击 直 接 访问 文章 内 容 。 在 index.ejs 中 添加 文 
章 内 容 页 的 URL， 具 体 如 下 : 





<h2><a href="/articles/<%= articles[i] .articleID%>"><%= articles[i]l.articleTitle 
多 ></a></h2> 


此 时 ,通过 浏览 器 访问 博客 首页 后 , 可 以 发 现 已 经 可 以 直接 通过 点 击 跳 转 至 文章 内 容 页 了 。 
还 需要 解决 的 问题 就 是 当 用 户 访问 文章 内 容 页 时 , 需要 增加 点 击 量 , 只 需要 对 该 篇 文章 的 
点 击 量 加 一 即 可 ， 对 文章 内 容 页 的 路 由 处 理 修改 为 以 下 代码 : 


router.get('/articles/:articleID', function(req, res, next) { 
Var articleID = req.params.articleID; 
Var query = 'SELECT * FROM article WHERE articleID=' + mysql.escape (articleID); 
mysql.query (query, function(err, rows, fields) { 
ifl(err) { 
console.log (err); 
return; 
} 
Var query = 'UPDATE article SET articleClick=articleClick+] WHERE articleID=" 
+ mysql.escape (articleID); 
var article = rows[0]; 
mysql.query (query, functionl(err, rows, fields) { 
if(err) { 
console.1log (err) 


return; 
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这 时 通过 刷新 浏览 器 可 以 发 现 每 篇 文章 的 浏览 量 增加 了 。 这 个 浏览 量 可 以 通过 内 容 页 和 首 
页 体现 ， 如 图 12.15 和 图 12.16 所 示 。 
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12.16 浏览 量 增加 的 首页 
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12.2.5 博客 文章 发 布 的 实现 

在 前 文中 项 目 已 经 通过 直接 向 MySQL 中 插入 文章 数据 来 查看 博客 首页 的 效果 和 文章 内 
容 页 的 效果 ， 这 里 将 直接 实现 文章 在 网 页 发 布 的 功能 。 

文章 发 布 的 页 面 和 登录 页 面 非常 类 似 ,页面 中 只 有 一 个 表单 ， 在 indexjs 文件 中 添加 对 这 
个 页 面 的 路 由 处 理 ， 代 码 如 下 : 





接 下 来 实现 这 个 页 面 的 视图 层 ， 在 views 文件 夹 中 新 建 一 个 名 为 edit.ejs 的 文件 ， 将 以 下 
代码 写 入 这 个 文件 中 : 





接 下 来 就 是 样式 的 实现 ， 将 以 下 代码 添加 到 main.css 文件 中 : 
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重新 启动 项 目 ， 在 浏览 器 中 输入 localhost3000/edit 这 个 URL， 可 以 在 浏览 器 中 看 到 文章 
发 布 页 面 ， 如 图 12.17 所 示 。 
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图 12.17 文章 发 布 页 面 


此 时 和 登录 页 面 一 样 ， 在 用 户 提交 数据 后 需要 操作 数据 库 。 这 里 需要 将 这 些 数据 添加 至 
MySQL 数据 库 。 在 这 之 前 还 需要 解决 一 个 问题 ， 就 是 如 何 能 够 识别 当前 登录 的 用 户 ， 从 而 将 
这 个 用 户 的 姓名 存储 到 数据 库 中 。 这 就 涉及 cookie 和 session 了 。 下 面 简要 说 明 一 下 cookie 和 
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session 。 

cookie 和 session 都 是 基于 服务 器 的 ，cookie 存储 在 浏览 器 客户 端 ， 而 session 存储 在 服务 
器 端 。 用 户 浏览 网 站 时 ， 会 在 浏览 器 客户 端 存储 一 些 有 关 用 户 信息 的 内 容 ， 这 些 便 是 cookie。 
当 用 户 再 次 访问 相同 的 网 站 时 ， 服 务 器 通过 检查 客户 端的 cookie 数据 而 返回 相应 的 内 容 。 
cookie 显然 是 通过 客户 端 来 保持 状态 的 ， 而 session 则 是 通过 服务 器 端 来 保持 状态 的 。 

session 数据 存储 在 服务 器 端 ， 当 用 户 访问 相同 网 站 的 时 候 ， 服 务 器 端 首先 检查 这 个 网 页 
请 求 中 是 否 含有 一 个 session 的 标识 , 有 则 在 服务 器 端 查找 是 否 有 相应 的 session 数据 以 及 这 个 
数据 是 否 过 期 , 服务 器 根据 结果 返回 相应 的 内 容 。 一 般 来 说 , 这 个 session 标识 可 以 称 为 session 
id， 这 个 session id 必须 是 不 易 发 现 规律 的 字符 串 ， 以 防止 其 他 用 户 盗 取 。 

一 般 来 说 ,不 重要 、 不 敏感 的 信息 可 以 使 用 cookie 存储 , 重要 、 敏 感 的 信息 应 该 使 用 session 
来 存储 ， 因 为 cookie 是 容易 被 网 站 攻击 者 盗 取 的 。 

使 用 express-session 模块 前 需要 通过 NPM 安装 : 


安装 express-session 模块 之 后 在 app.js 文件 中 引入 : 


引入 express-session 模块 之 后 添加 以 下 代码 使 用 这 个 模块 : 





若 需 要 判断 当前 登录 的 用 户 是 谁 则 需要 在 用 户 登 录 的 时 候 将 用 户 信 息 添加 到 session 中 。 
在 index.js 中 登录 路 由 post 请 求 中 查询 完 用 户 信息 后 将 用 户 信 息 添 加 到 session 中 , 代码 如 下 : 


此 时 ， 登 录 post 请 求 的 处 理 代码 如 下 : 
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此 时 ， 用 户 登 录 后 用 户 的 信息 就 会 存储 在 session 中 。 当 用 户 发 布 文章 时 将 这 些 信息 提取 
出 来 就 可 以 了 。 
在 index.js 中 添加 用 户 发 布 文章 的 post 请 求 处 理 ， 将 以 下 代码 添加 到 index.js 文件 中 : 





重新 启动 项 目 ， 登 录 博客 后 添加 文章 保存 , 可 以 在 博客 项 目的 首页 看 到 保存 的 文章 ， 点击 
就 可 以 看 到 文章 的 内 容 了 ， 如 图 12.18 和 图 12.19 所 示 。 
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图 12.19 添加 的 文章 内 容 页 

此 时 , 用 户 已 经 可 以 通过 博客 项 目 来 添加 文章 了 , 但 是 现在 这 个 项 目 中 存在 两 个 明显 的 问 
题 : 一 是 用 户 添加 的 文章 是 出 现在 博客 首页 的 文章 列表 最 后 的 ， 良 好 的 用 户 体验 应 该 是 让 最 近 
发 布 的 文章 出 现在 首页 文章 列表 的 最 前 方 ， 二 是 用 户 没 有 登录 也 可 以 访问 发 布 文章 这 个 页 面 ， 
此 时 单 击 “ 保 存 ” 会 引起 错误 ， 因 为 并 不 能 从 session 中 提取 登录 用 户 的 信息 。 

第 一 个 问题 通过 改变 首页 选取 数据 库 记录 的 SQL 语句 就 可 以 解决 .将 SQL 语句 改 为 以 下 
代码 : 
Var query = 'SELECT * FROM article ORDER BY articleID DESC'; 
重新 启动 项 目 ， 在 浏览 器 中 访问 项 目 首页 ， 可 以 看 到 文章 倒序 出 现在 首页 中 ， 如 图 12.20 
所 示 。 








239 


Node 的 个 人 博客 





Nodejs 基 础 知识 


和 : node 时 





图 12.20 文章 倒序 排列 的 博客 首页 


第 二 个 问题 只 要 在 用 户 访问 文章 发 布 页 面 的 时 候 做 一 个 判断 ， 判 断 session 中 是 否 存在 用 
户 信息 ,不 存在 就 将 页 面 重 定向 至 登录 页 面 。 将 访问 文章 发 布 页 面 的 路 由 处 理 修改 为 以 下 代码 : 





router.get('/edit', function(req, res, next) { 
Var user = req.session.user; 
if(!user) { 
res.redirect ('/login'); 
return; 


} 
res.render('edit'); 


1); 

重新 启动 项 目 , 在 用 户 没有 登录 的 情况 下 访问 文章 发 布 页 面 , 可 以 发 现 页 面 被 重 定向 至 登 
录 界 面 ， 用 户 登 录 之 后 就 可 以 访问 发 布 文章 的 页 面 。 

最 后 将 文章 页 面 的 URL 写 入 aside.ejs 文件 中 ， 就 可 以 通过 点 击 来 直接 访问 这 个 发 布 
页 面 了 : 
<aside> 


<section class="main-aside-avatar"> 





<img src="/img/avatar.jpg" alt= 
</section> 
<ul> 
<1i><a href="/edit"> 撰 写 文章 </a></1i> 
<1i><a href=""> 关 于 博客 </a></1i> 
<1i><a href=""> 友 情 链接 </a></1i> 
<1i><a href=""> 登 出 博客 </a></1i> 
</ul> 
</aside> 
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此 时 文章 发 布 的 功能 就 实现 了 。 


12.2.6 博客 友情 链接 的 实现 


此 时 博客 项 目 雏形 已 有 , 具备 基本 的 文章 发 布 和 文章 查看 功能 。 为 了 让 整个 项 目 看 起 来 更 
加 完整 ， 这 里 添加 一 个 友情 链接 的 页 面 。 这 个 项 目 中 友情 链接 页 面 是 一 个 静态 页 面 。 
在 route 文件 夹 下 的 indexjs 文件 中 添加 以 下 代码 : 





在 views 文件 夹 下 新 建 一 个 名 为 friends.ejs 的 视图 模板 ， 写 入 以 下 内 容 : 





在 main.css 文件 中 写 入 以 下 代码 作为 这 个 页 面 的 样式 : 
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} 
.friends 1i{ 


float:left; 
width:25%; 
height:30px; 
line-height:30px; 

} 

.friends li a:hover{ 
Color:#183D8E; 

} 








新 启动 项 目 ， 可 以 在 浏览 器 中 看 到 友情 链接 页 面 ， 如 图 12.21 所 示 。 





Node 的 友情 链接 网 站 
Grtrub CNode SegmentFault Google 
NPM Ruby china W3cschool MDN 





Copyright © 2016 Node 
Powered by Esprass 


图 12.21 友情 链接 页 面 


此 时 ， 一 个 静态 的 友情 链接 页 面 已 经 构建 完成 。 


12.2.7 ”博客 关于 博客 的 实现 
关于 博客 页 面 和 友情 链接 页 面 类 似 ， 也 是 一 个 静态 页 面 。 
在 route 文件 夹 下 的 indexjs 文件 中 添加 以 下 代码 : 
router.get('/about', function(req, res, next) { 


res.render('about'); 
1D); 


在 views 文件 夹 下 新 建 一 个 名 为 about.ejs 的 视图 模板 ， 写 入 以 下 内 容 : 


<!DOCTYPE html> 
<html lang="zh-cn"> 
<head> 


242 


<$- include("./public/head.ejs")%> 
</head> 
<body> 
<%- include("./public/header.ejs")%> 
<section class="main floatfix"> 
<%- include("./public/aside.ejs")%> 
<section class="main-articles about"> 


<h2> 关 于 博客 </h2> 


<p> 本 博客 主要 分 享 Node .js 和 前 端 技术 ,希望 和 大 家 共同 成 长 。</p> 


</section> 
</section> 
<%- include("./public/footer.ejs")%®> 
</body> 
</html> 


在 main.css 文件 中 写 入 以 下 代码 作为 这 个 页 面 的 样式 : 


.about h21{ 

text-align: center; 
} 
.about pi{ 

text-indent: 2em; 


重新 启动 项 目 ， 可 以 在 浏览 嚣 中 看 到 关于 博客 页 面 ， 如 图 12.22 


Ee—— ee 


关于 博客 


二 光 窜 二 区 吾 Node js 前 二 本 相 ， 珊 章 科 大宗 二 同 于 
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12.2.8 博客 404 页 面 的 实现 


404 页 面 依旧 是 一 个 静态 页 面 ， 在 所 有 路 由 都 没有 匹配 到 的 情况 下 就 作为 404 处 理 。 
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将 appjs 文件 中 原来 对 404 页 面 的 处 理 修改 为 如 下 代码 : 





在 views 文件 夹 中 新 建 一 个 名 为 404.ejs 的 视图 文件 ， 添 加 以 下 代码 : 





在 main.css 中 添加 以 下 代码 作为 404 页 面 的 样式 : 





重新 启动 项 目 ， 在 浏览 器 中 输入 一 个 404 的 URL， 如 localhost:3000/aaaa， 可 以 看 到 404 
页 面 已 经 呈现 ， 如 图 12.23 所 示 。 
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404, 你 来 到 了 没有 信息 的 沙漠 





图 12.23 项 目 404 页 面 


12.2.9 博客 侧 边栏 的 优化 


整个 博客 项 目 基 本 成 形 , 但 是 目前 并 不 能 通过 侧 边 栏 来 跳 转 到 各 个 页 面 , 需要 优化 一 下 侧 
边栏 。 

本 项 目 设 定 ， 当 用 户 登 录 了 博客 时 , 侧 边 栏 中 显示 “ 登 出 博客 ”; 当 用 户 没 有 登录 博客 时 ， 
侧 边 栏 中 显示 “登录 博客 ” 

将 aside.ejs 文件 修改 为 以 下 代码 : 


<aside> 
<section class="main-aside-avatar"> 
<img src="/img/avatar.jpg" alt=""> 
</section> 
<ul> 
<1i><a href="/"> 博 客 首页 </a></1i> 
<1i><a href="/about"> 关 于 博客 </a></1i> 
<1i><a href="friends"> 友 情 链接 </a></1i> 
<1i><a href="/edit"> 撰 写 文章 </a></1i> 
<1i><a href="/1ogin"> 登 录 博 客 </a></1i> 
</ul> 
</aside> 


重新 启动 项 目 ， 可 以 发 现 博客 已 经 可 以 通过 侧 边栏 来 实现 各 个 页 面 的 跳 转 。 
判断 用 户 是 否 登录 ， 只 需要 判断 用 户 是 否 存 在 session 中 ， 当 在 页 面 中 泻 染 视图 时 ， 将 这 
结果 传递 给 模板 即 可 。 以 关于 博客 页 面 为 例 ， 将 路 由 处 理 改 为 如 下 代码 : 


router.get('/about', function(req, res, next) { 


























res.render('about', {user:req.session.user}); 
Ds; 
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同时 ， 将 aside.ejs 文件 修改 为 以 下 代码 : 


<aside> 

<section class="main-aside-avatar"> 
<img src="/img/avatar.jpg" alt=""> 

</section> 

<ul> 
<1i><a href="/"> 博 客 首 页 </a></1i> 
<1i><a href="/about"> 关 于 博客 </a></1i> 
<1i><a href="friends"> 友 情 链接 </a></1i> 
<1i><a href="/edit"> 撰 写 文章 </a></1i> 
<% if(user) { 多 > 
<1i><a href="/logout"> 登 出 博客 </a></1i> 
<% } else { 多 > 
<1i><a href="/1login"> 登 录 博 客 </a></1i> 





<% } $%> 
</ul> 
</aside> 
重新 启动 项 目 , 可 以 发 现 侧 边栏 已 经 可 以 通过 判断 用 户 是 否 登 录 来 显示 不 同 的 内 容 了 , 如 


图 12.24 和 图 12.25 所 示 。 
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图 12.24 用 户 未 登录 的 首页 
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图 12.25 用 户 已 经 登录 的 首页 
接 下 3 





实现 用 户 登 出 博客 的 功能 。 在 index.js 文件 中 添加 以 下 代码 : 


router.get('/logout', function(req, res, next) { 
req.session.user = null; 
res.redirect('/'); 

1); 


重新 启动 项 目 ， 可 以 发 现 用 户 通 过 点 击 即 可 登 出 博客 。 


12.2.10 ”博客 修改 文章 的 实现 


博客 中 的 文章 难免 会 需要 修改 , 现在 整个 项 目 并 不 能 修改 文章 , 这 里 将 实现 文章 修改 的 功 


在 index.js 文件 中 添加 以 下 代码 : 


router.get('/modify/:articleID', function(req, res, next) { 
var articleID = req.params.articleID; 
var user = req.session.user; 
Var query = 'SELECT * FROM article WHERE articleID=' + mysql.escape (articleID); 
if(!user) { 
res.redirect('/login'); 


return; 

1 

mysql.query (query, function(err, rows, fields) { 
if(err) { 


console.log(err); 
return; 
} 


var article = rows[0]; 
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接 下 来 就 是 添加 文章 的 视图 模板 ,在 views 文件 夹 下 新 建 一 个 名 为 modify.ejs 的 模板 文件 ， 
写 入 以 下 代码 : 





重新 启动 项 目 ， 登 录 之 后 在 浏览 器 中 输入 localhost:3000/modify/1， 就 可 以 看 到 第 一 篇 文 
章 的 修改 页 面 ， 如 图 12.26 所 示 。 
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图 12.26 文章 修改 页 面 
这 时 文章 修改 页 面 已 经 可 以 在 登录 之 后 正常 访问 了 。 接 下 来 添加 文章 修改 后 的 数据 库 操 
作 ， 在 index.js 文件 中 添加 以 下 代码 : 


router.post('/modify/:articleID', function(req, res, next) { 
var articleID = req.params.articleID; 
Var user = req.session.user; 
var title = req.body.title; 
var content = req.body.content; 
var query = 'UPDATE article SET articleTitle=' + mysql.escape (title) + 
"varticleContent=' + mysql.escape (Content) + 'WHERE articleID=' + 
mysql.escape (articleID) 
mysql.query (query, function (err，Irows，fields) { 
if(err) { 
console.log (err); 
return; 
1 
res.redirect ('/'); 





新 启动 项 目 ， 已 经 可 以 正常 修改 文章 内 容 了 。 例 如， 第 一 篇 文章 修改 后 的 文章 内 容 页 面 
如 图 12.27 所 示 。 
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图 12.27 第 一 篇 文章 修改 后 的 页 面 
接 下 来 在 博客 首页 中 添加 每 篇 文章 修改 的 链接 。 修 改 index.ejs 文件 ， 添 加 编辑 页 面 的 链接 : 


<P> 
<span> 作 者 : <%= articles[i] .articleAuthor %></span> 
<span> 发 布 时 间 : <%= articles[i] .articleTime %></span> 
<span> 浏 览 量 : <%$= articles [i] .articleClick %></span> 
<% if(user) {%> 
<span class="modify"><a href="/modify/<%= articles[i] .articleID %>"> 编 辑 
</a></span> 
bb 
</P> 


此 时 ，index.ejs 文件 的 内 容 如 下 : 


<!DOCTYPE html> 
<html lang="zh-cn"> 
<head> 
<%- include("./public/head.ejs")%> 
</head> 
<body> 
<%- include("./public/header.ejs")%®> 
<section class="main floatfix"> 
<%- include ("./public/aside.ejs")s> 
<section class="main-articles"> 
<ul> 
<% for(var i = 0, max = articles.length; i < max; i++) {%> 
<1li class="main-articles-item"> 
<h2><a href="/articles/<%= articles[i] .articleID%>"><%= 
articles[i] .articleTitle %></a></h2> 
<section class="main-articles-items-des"> 
<p> 
<span> 作 者 : <%= articles[i] .articleAuthor %></span> 
<span> 发 布 时 间 : <%= articles[i].articleTime %></span> 
<span> 浏 览 量 : <%= articles[i].articleClick %></span> 
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<% if(user) {%> 
<span class="modify"><a href="/modify/<%= articles[i].articleID %>"> 
编辑 </a></span> 
< > 
</p> 
</section> 
</1i> 
< } $> 
</ul> 
</section> 
</section> 
<%- include("./public/footer.ejs")%> 
</body> 
</html> 


在 main.css 中 添加 以 下 代码 作为 编辑 链接 的 样式 : 


span.modify{ 
float:right; 

} 

span.modify a:hover{ 
Color:#183D8E; 


重新 启动 项 目 ， 在 登录 之 后 就 可 以 通过 首页 的 编辑 链 
如 图 12.28 所 示 。 


一 一 


Nodejs 技 术 展开 


接 直接 跳 转 至 每 篇 文章 的 编辑 页 面 ， 
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图 12.28 添加 编辑 链接 的 首页 


12.2.11 ”博客 删除 文章 的 实现 


博客 中 的 文章 难免 会 有 删除 的 时 候 ， 这 里 将 实现 删除 文章 的 功能 。 
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在 indexjs 文件 中 添加 以 下 代码 : 


接 下 来 在 博客 首页 中 添加 每 篇 文章 删除 的 链接 。 修 改 index.ejs 文件 ， 添 加 删除 文章 的 链接 : 


此 时 ，index.ejs 文件 内 容 如 下 : 





<span> 作 者 : <%= articles[i].articleAuthor %></span> 
<span> 发 布 时 间 : <%= articles[i] .articleTime %></span> 
<span> 浏 览 量 : <s= articles[i]l.articleCclick 


<% if(user) {%> 


<span class="delete"><a href="/delete/<%= 


删除 </a></span> 


<span class="modify"><a href="/modify/<%= 


编辑 </a></span> 
<% } $> 
</p> 
</section> 
EE 
<% } %> 
</ul> 
</section> 
</section> 
<%- include("./public/footer.ejs")%®> 
</body> 
</html> 


在 main.css 中 添加 以 下 代码 作为 删除 链接 的 样 


span.deletef{ 
float:right; 

} 

span.delete a:hover{ 
color:#183D8E; 


重新 启动 项 目 , 登录 之 后 可 以 通过 首页 
首页 如 图 12.29 所 示 。 





的 删除 链接 来 删除 
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图 12.29 删除 第 一 篇 文章 后 的 首页 
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12.2.12 ”博客 文章 分 页 的 实现 


当 博 客 文章 数量 多 的 时 候 , 将 所 有 文章 放 在 同一 个 页 面 显 然 对 用 户 来 说 是 不 友好 的 。 下 面 
实现 文章 分 页 的 功能 。 

文章 分 页 在 这 里 规定 每 个 页 面 最 多 8 篇 文章 ， 可 利用 URL 中 的 query 字符 串 来 实现 。 数 
据 库 中 的 SQL 查询 可 以 通过 LIMIT 字句 限制 文章 的 篇 数 , 通过 查询 当前 数据 库 中 文章 的 总 篇 
数 来 判断 是 否 需要 分 页 ， 如 果 文 章 的 总 篇 数 超过 8 篇 就 分 页 ， 不 超过 8 篇 则 不 分 页 。 

在 route 文件 夹 下 的 indexjs 文件 中 对 首页 的 处 理 修改 为 以 下 代码 : 





在 首页 的 模板 中 添加 分 页 的 实现 : 























Express 开发 个 人 博客 系统 


此 时 indes.ejs 模板 中 的 代码 应 该 如 下 : 





</section> 

<%- include ("./pPublic/footer.ejs")s> 
</body> 

</html> 


在 main.css 中 添加 分 页 的 样式 ， 写 入 以 下 代码 : 


.Pagei{ 
text-align:center; 
margin-top:15px; 

} 

.Page spant{ 
display: inline-block; 
background: #fff; 
width: 24px; 
margin: 0 Spx; 
line-height: 24px; 
height: 24px; 

} 

.Page span alf 
display: block; 

} 

.Page span.active af 
background: #183D8E; 
color:#fff; 

} 

.Page span:hover af{ 
background: #183D8E; 
Color:#fff; 


重 
篇 时 不 会 分 页 ， 点 击 分 页 按钮 可 以 实现 跳 转 ， 如 图 12.30 和 图 12.31 所 示 。 
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图 12.30 文章 篇 数 小 于 8 时 不 分 页 


256 


启动 项 目 ， 添 加 几 篇 文章 ， 当 文章 的 篇 数 大 于 8 篇 时 就 会 出 现 分 页 ， 文 章 篇 妆 
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加 : 


图 12.31 文章 篇 数 大 于 8 时 分 页 
文章 分 页 的 功能 就 实现 了 。 


1 2 .3 引 项 目 总 结 


在 本 章 中 ， 我 们 通过 一 个 简单 的 个 人 博客 项 目 进一步 了 解 了 Express 框架 和 MySQL 的 使 
用 , 通过 前 端 界 面 设计 、 数 据 库 设计 、 后 端 路 由 开发 介绍 了 整个 项 目的 开发 流程 。 当 然 ， 有 兴 
趣 的 读者 还 可 以 继续 优化 这 个 项 目 ， 如 添加 评论 功能 、 添 加 标签 分 类 功能 等 。 
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-个 任务 清单 项 目 是 众多 语言 和 框架 学 习 的 第 一 步 。 任 务 清单 也 就 是 平时 提 到 的 ToDo 

List。 一 个 任务 清单 项 目 虽 然 简 单 ， 但 是 往往 能 展现 这 个 框架 的 核心 。Meteor 是 一 个 里 程 碑 式 
的 全 栈 开发 平台 。 正如 其 名 , Meteor 的 魅力 在 于 快速 开发 、 减 少 重复 工作 。 MongoDB 是 Meteor 
官方 推荐 使 用 的 数据 库 。 本 章 将 通过 实际 编码 来 实现 一 个 任务 清单 项 目 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 

@ 连接 MySQL 数据 库 并 进行 操作 。 

@ 连接 MongoDB 数据 库 并 进行 操作 。 

@ 了 解数 据 库 的 基础 知识 。 





项 目 准备 


13.1.1 Meteor 和 MongoDB 的 安装 

Meteor 和 MongoDB 作为 本 次 开发 的 平台 和 使 用 的 数据 库 ， 在 项 目 开始 时 ， 应 该 确保 
Meteor 和 MongoDB 已 经 安装 好 。 

有 关 Meteor 的 安装 ， 只 需要 在 官方 网 站 下 载 对 应 的 操作 系统 的 版 本 进行 安装 即 可 。Meteor 
的 官方 网 站 是 https://www.meteor.com/， 在 安装 之 前 应 该 确保 已 经 安装 Node.js， 如 图 13.1 所 示 。 





Mm 7 (io 





and Linu 





OSX/LINUX WINDOWS 


Instal the latest official Meteor release from yourtermrinal Simply download and run the official Meteorinstaller 


curl https://install.neteor.com/ | sh DD DOWNLOAD INSTALLER 


图 13.1 Meteor 安装 











MongoDB 的 安装 同样 是 在 官方 网 站 下 载 对 应 的 版 本 即 可 ， 在 前 面 章节 中 已 经 详细 介绍 ， 
这 里 就 不 再 赣 述 了 。MongoDB 的 官方 网 站 是 https://www.mongodb.com/。 
Meteor 和 MongoDB 安装 完成 之 后 ， 使 用 meteor--version 命令 查看 Meteor 版 本 以 确保 安 


装 成 功 : 
meteor --version 
确保 安装 完成 之 后 使 用 meteor create list 命令 来 创建 项 目 : 
meteor create list 
经 过 一 段 时 间 的 等 待 安装 ， 安 装 完成 之 后 在 命令 行 中 可 以 看 到 Meteor 已 经 指示 了 如 何 启 
动 整个 项 目 ， 如 图 13.2 所 示 。 


-~full t 





图 13.2 项 目 初始 化 完成 后 的 界面 
按照 指示 使 用 命令 来 启动 这 个 项 目 : 
cd List 
meteor 
启动 这 个 项 目的 过 程 中 ，Meteor 也 同时 启动 了 MongoDB， 命 令 行 界面 指示 项 目 运行 的 端 
口 已 经 停止 项 目 运行 的 命令 ， 如 图 13.3 所 示 。 








到 


13.3 项 目 启动 的 命令 行 画面 











在 浏览 器 中 输入 http://localhost:3000/, 可 以 看 到 Meteor 默认 项 目的 页 面 , 如 图 13.4 所 示 。 
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Welcome to Meteor! 
[ca 


You've pressed the button 0 times. 


Learn Meteor! 





13.4 ”Meteor 默认 初始 页 面 
在 Meteor 项 目 中 使 用 命令 行 meteor mongo 即 可 打开 MongoDB， 这 对 开发 中 数据 的 初始 
测试 非常 有 用 。 
13.1.2 项 目 设计 


一 个 任务 清单 应 该 具备 的 基本 功能 是 可 以 增加 任务 、 删 除 任务 、 完 成 任务 , 可 用 一 张 简 单 
的 草图 表示 ， 如 图 13.5 所 示 。 























EE 





图 13.5 项 目 草 图 


在 数据 库 方面 的 设计 就 是 需要 表明 当前 任务 的 状态 、 任务 的 具体 内 容 , 在 MongoDB 中 表 
示 类 似 于 : 


完成 基本 的 功能 设计 之 后 需要 对 项 目的 目录 结构 进行 设计 。 在 项 目的 根 目录 下 新 建 一 个 
public 文件 夹 作 为 存放 静态 资源 的 文件 夹 ， 新 建 一 个 imports 文件 夹 作 为 开发 过 程 中 主要 使 用 
的 文件 夹 , 在 imports 文件 夹 下 新 建 一 个 名 为 models 的 文件 夹 作 为 数据 的 文件 夹 ， 同时 新 建 一 
个 名 为 controllers 的 文件 夹 作为 主要 的 逻辑 控制 文件 夹 ， 同时 新 建 一 个 名 为 views 的 文件 夹 作 
为 HTML 文件 存放 的 文件 夹 ， 整 个 项 目的 目录 结构 大 致 如 图 13.6 所 示 。 
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图 13.6 项 目 目录 结构 
此 时 项 目 开 发 的 准备 已 经 完成 。 


项 目 开发 


13.2.1 项 目 展示 功能 开发 


按照 上 文中 文件 目录 结构 功能 的 划分 ， 将 client 文件 夹 中 的 main.html 文件 内 容 修改 为 以 
下 内 容 : 


<head> 
<title> 任 务 清单 </title> 
</head> 
在 views 文件 夹 下 新 建 一 个 名 为 index.html 的 文件 ， 写 入 以 下 内 容 : 
<body> 


<div class="container"> 
{{> listHead}} 
{{> listInput}} 
{{> listContent}} 
</div> 
</body> 


在 这 个 结构 中 已 经 非常 明确 地 将 页 面 划分 成 了 三 个 部 分 , 在 views 文件 夹 中 新 建 三 个 名 为 
listHead.html、listInput.html、listContent.html 的 文件 。 其 中 ，listHead.html 的 文件 内 容 如 下 : 


<!- 定 义 1istHead 模板 --> 
<Template name="listHead"> 

<h1> 任 务 清单 </h1> 
</Template> 
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listInput.html 的 文件 内 容 如 下 : 





listContenthtml 文件 的 内 容 如 下 : 





这 个 文件 中 再 次 将 任务 的 条 数 分 隔 为 不 同 的 模板 。 再 新 建 一 个 名 为 listItem.html 的 文件 ， 
写 入 以 下 内 容 : 





此 时 基本 的 模板 内 容 开 发 完毕 ， 接 下 来 试 着 填充 一 些 数据 使 整个 内 容 可 见 。 

在 controllers 文件 夹 中 新 建 名 为 indexjs 和 listContentjs 的 文件 。 其 中 ，index.js 文件 作为 
该 文件 夹 中 所 有 文件 的 导出 文件 ，listContent.js 文件 对 应 于 listContent.html 文件 中 的 数据 。 

向 listContentjs 文件 中 写 入 以 下 内 容 : 





262 


【[ 第 13 章 使 用 Meteor+MongoDB 开发 任务 清 征 





| 
最 后 利用 indexjs 文件 将 其 导出 即 可 : 


将 client 文件 夹 下 main.js 文件 中 的 内 容 修改 为 以 下 内 容 : 


利用 命令 行 工 具 运 行 meteor run 指令 即 可 在 本 地 服务 器 的 3000 端口 看 到 图 13.7 所 示 的 页 
面 ， 说 明 数 据 已 经 可 以 在 页 面 中 展示 出 来 了 。 

















图 13.7 初始 页 面 


13.2.2 项目 页 面 美化 


一 个 优秀 的 应 用 必然 少不了 漂亮 、 美观 的 UI 界面 , 这 一 小 节 将 着 重 介绍 页 面 的 美化 工作 。 
在 public 文件 夹 中 添加 一 个 名 为 bg.jpg 的 文件 ， 因 为 public 文件 夹 中 的 文件 将 会 发 送 到 
client， 所 以 直接 使 用 即 可 。 向 main.css 中 写 入 以 下 内 容 : 
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使 用 Meteor+MongoDB 开发 任务 清和 





打开 页 面 ， 可 以 看 到 整个 页 面 变 得 更 加 美观 了 ， 如 图 13.8 所 示 。 





图 13.8 优化 后 的 页 面 


13.2.3 项目 数据 库 开发 


Meteor 使 用 MongoDB 作为 后 端 数 据 库 。MongoDB 使 用 集合 和 文档 的 概念 。 创 建 一 个 集 
合 只 需要 使 用 new Mongo.Collection0 即 可 ， 同 时 在 Meteor 中 数据 库 可 以 直接 映射 到 前 端 。 在 
models 文件 夹 中 新 建 一 个 名 为 index.js 的 文件 ， 利 用 这 个 文件 来 创建 MongoDB 数据 库 文档 ， 
在 这 个 文件 中 写 入 以 下 内 容 : 


完成 文档 的 创建 之 后 需要 将 数据 展现 在 前 端 页 面 .在 前 面 的 章节 中 我 们 在 listContent 模板 
上 使 用 的 是 自己 填 入 的 数据 ， 而 在 实际 中 需要 真正 使 用 数据 库 中 的 数据 ， 只 需要 在 listContent 
中 将 数据 库 中 的 数据 查找 出 来 填充 即 可 。 在 MongoDB 中 使 用 find() 方 法 即 可 将 所 有 的 数据 以 
数组 的 形式 查找 出 来 。 将 listContent 的 文件 内 容 修 改 为 以 下 内 容 : 
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因为 创建 这 个 文档 的 同时 也 需要 在 server 端 执行 ， 所 以 将 其 导入 即 可 ， 也 就 是 将 server 
文件 夹 下 的 mainjs 文件 修改 为 以 下 内 容 : 





此 时 页 面 中 没有 任何 任务 内 容 ， 因 为 数据 库 中 没有 内 容 。 可 以 通过 命令 行 填充 部 分 数据 ， 
在 项 目 根 目录 下 使 用 命令 行 工 具 运 行 命令 meteor mongo: 


连接 好 MongoDB 数据 库 之 后 即 可 使 用 命令 进行 数据 库 的 增删 查 改 。 运行 以 下 命令 手动 增 
加 两 条 数据 : 


运行 完毕 ， 可 以 看 到 项 目 页 面 同时 出 现 了 这 两 项 任务 ， 如 图 13.9 所 示 。 





图 13.9 从 数据 库 中 调 取 数据 


13.2.4 项 目 操作 逻辑 开发 


此 时 页 面 中 已 经 可 以 展示 数据 库 中 的 数据 了 , 但 是 并 不 能 实现 任务 的 增删 , 本 小 节 将 实现 
这 些 功能 。 

Meteor 中 每 个 模板 的 事件 可 以 使 用 Template.body.events 定义 。 同 时 ， 因 为 前 端 已 经 具备 
了 操作 数据 库 的 功能 ， 所 以 直接 在 事件 中 对 数据 进行 操作 即 可 ， 不 再 需要 像 传统 的 项 目 那 样 ， 
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提交 到 后 端 来 处 理 。 
向 controllers 文件 夹 中 的 listContentjs 文件 中 添加 增加 任务 的 功能 。 添 加 任务 使 用 submit 
事件 进行 处 理 即 可 ， 即 添加 以 下 内 容 : 





在 浏览 器 页 面 的 输入 框 中 添加 任务 内 容 , 按 Enter 键 之 后 就 可 以 看 到 任务 已 经 添加 到 任务 
栏 中 了 

得 益 于 Meteor 的 模板 数据 上 下 文 ， 删 除 任务 实现 也 是 非常 简单 的 ， 可 继续 在 events 中 添 
加 以 下 内 容 : 





更 新 任务 是 否 完成 的 功能 实现 如 下 : 





整体 事件 处 理 代码 如 下 : 





267 





Node.js 开发 实战 加 





此 时 在 浏览 器 中 已 经 可 以 添加 和 删除 任务 了 , 但 是 并 不 能 直观 地 发 现任 务 是 否 完成 , 可 以 
通过 判断 任务 是 否 完成 来 将 相应 的 任务 以 不 同 的 样式 标识 出 来 。 将 listItem.html 文件 修改 为 以 
下 内 容 : 





向 main.css 中 添加 以 下 内 容 : 





此 时 已 经 可 以 向 项 目 中 添加 、 删 除 和 更 新 任务 ， 完 成 了 项 目的 基本 功能 。 不 过 为 了 使 新 添 
加 的 项 目 可 以 在 整个 项 目 列表 的 最 前 方 , 还 需要 对 项 目的 创建 时 间 进行 一 个 倒序 排序 。 新 建 一 
个 createAt 的 字段 ， 将 添加 任务 的 事件 处 理 函 数 修改 为 以 下 内 容 : 
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将 任务 的 展示 数据 进行 排序 ， 修 改 代码 为 以 下 内 容 : 


任务 项 目 就 可 以 按照 创建 时 间 倒 序 排列 了 。 
在 一 个 任务 清单 中 , 同样 应 该 使 用 户 能 够 清楚 地 了 解 到 哪些 任务 完成 了 、 哪 些 任务 没有 完 
成 。 下 面 在 项 目 中 添加 这 个 功能 。 将 views 文件 夹 下 的 listHead.html 文件 修改 为 以 下 内 容 : 


同时 在 main.css 文件 中 添加 以 下 内 容 作为 样式 : 
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在 这 里 需要 思考 一 个 问题 :如 何 才能 保存 用 户 选择 的 清单 展示 类 型 呢 ? 最 简单 的 就 是 利用 
一 个 变量 ， 然 而 listHead 和 listContent 属于 不 同 的 模板 并 且 不 属于 同一 个 文件 ， 也 就 是 说 一 个 
简单 的 JavaScript 变量 并 不 能 完成 这 个 任务 。 这 时 可 以 利用 Meteor 中 的 session。 将 变量 作为 
session 存储 在 内 存 中 就 可 以 方便 地 取 用 了 。 在 controllers 文件 夹 中 新 建 一 个 名 为 listHeadjs 的 
文件 ， 写 入 以 下 内 容 : 


此 时 展示 类 型 已 经 存储 在 session 中 了 ， 只 需要 在 调用 数据 的 时 候 将 session 取出 来 , 根据 
这 个 值 来 对 数据 进行 选择 即 可 。 将 listContent 模板 的 helpers 取 用 修改 为 以 下 内 容 : 








同样 在 插入 数据 的 时 候 应 该 设置 一 个 completed:false 的 字段 , 将 表单 提交 事件 修改 为 以 下 
内 容 ; 
import { Template } from 'meteor/templating'7 
import Lists from './../models/index'; 


/> 定义 事件 */ 
Template.listInput.events({ 
'submit form' (event){ 
event .preventDefault (); 
const text = event.target.text.value; 


if(text.trim() .length > 0) { 
Lists.insert ({content: text, createdAt: new Date(), completed: false}); 
这 清 


eVent .target .text.value = 


} 
}v 
}) 7 


此 时 在 浏览 器 的 http://losthost:3000 网 址 就 可 以 通过 选择 来 对 任务 进行 分 类 了 。 


发 布 与 订阅 


在 上 文中 的 Meteor 项 目 中 ， 在 服务 端 和 浏览 器 端 都 可 以 操作 数据 库 ， 并 且 所 有 的 数据 都 
同步 映射 到 了 客户 端 。 这 在 实际 开发 中 是 非常 不 推荐 的 。 当 然 这 是 因为 Meteor 项 目 默认 集成 
了 autopublish 包 ， 所 以 所 有 的 数据 都 会 自动 映射 到 客户 端 ， 因 此 在 项 目 上 线 之 前 我 们 应 该 把 
这 个 包 去 掉 ， 同 时 去 掉 的 包 还 有 insecure。 

删除 一 个 Meteor 包 是 非常 简单 的 ， 可 以 使 用 以 下 命令 删除 上 面 的 两 个 包 : 





meteor remove autopublish insecure 


运行 完成 之 后 可 以 在 命令 行 中 看 到 这 两 个 包 已 经 删除 的 提示 ， 如 图 13.10 所 示 。 





图 13.10 删除 包 
删除 这 两 个 包 之 后 我 们 需要 使 用 Meteor 的 发 布 一 订阅 模式 获取 数据 ， 同 时 需要 利用 
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Meteor.methods 来 定义 相应 的 方法 。 
首先 我 们 需要 在 创建 集合 之 后 定义 对 应 的 操作 数据 库 的 方法 ， 将 models 文件 夹 下 的 
index.js 文件 内 容 修 改 为 以 下 内 容 : 





在 这 段 代码 中 定义 了 相应 的 操作 数据 库 的 方法 ,因此 在 客户 端 触发 各 个 事件 时 需要 调用 相 
应 的 数据 库 操作 方法 来 对 数据 进行 操作 。 

在 Meteor 中 直接 使 用 Meteor.call 方法 即 可 调用 定义 在 Meteor.methods 下 的 方法 。 这 个 函 
数 的 第 一 个 参数 是 需要 调用 的 函数 的 名 字 ， 其 他 参数 对 应 于 调用 函数 需要 传 入 的 参数 值 。 

根据 Meteor 的 数据 上 下 文 ， 非 常 容易 得 到 这 些 方 法 的 参数 ， 因 此 将 添加 任务 的 事件 处 理 
函数 修改 为 以 下 内 容 : 
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删除 任务 的 事件 处 理 函 数 如 下 : 





更 新 任务 是 否 完成 的 事件 处 理 函 数 如 下 : 





这 相当 于 我 们 对 项 目的 事件 处 理 函数 都 进行 了 一 次 重 写 。 

利用 Meteor 的 发 布 一 订阅 机 制 , 我 们 需要 判断 是 否 为 服务 端 ， 如果 是 服务 端 就 进行 发 布 ， 
如 果 是 客户 端 就 进行 订阅 。 

使 用 Meteor.isServer 就 可 以 确保 其 中 的 代码 只 运行 在 服务 端 , 使 用 Meteor.publish() 方 法 即 
可 发 布 。 在 models 文件 夹 下 的 indexjs 文件 中 添加 以 下 内 容 : 





这 个 文件 的 所 有 内 容 如 下 所 示 。 
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在 服务 端 进行 发 布 之 后 ， 在 客户 端 使 用 Meteor.subscribe 方法 就 可 以 订阅 了 。 如 果 在 项 目 
创建 的 时 候 进行 订阅 ， 就 可 以 将 订阅 放 在 Template.body.onCreated() 中 ， 代 码 如 下 : 


打开 浏览 器 ， 项 目 依 旧 正 常 运行 ， 如 图 13.11 所 示 。 





国 nelojavascnpt 





图 13.11 项 目 运行 截图 
至 此 ， 一 个 简单 的 任务 清单 项 目 就 完成 了 。 


1 3 引 .4 项目 总 结 


本 章 通过 一 个 任务 清单 项 目 简 单 了 解 了 Meteor 项 目的 开发 。 从 中 可 以 发 现 Meteor 开发 速 
度 非常 快 。 这 是 一 个 里 程 碑 式 的 创新 。 感 兴趣 的 读者 可 以 对 这 个 项 目 进 行进 一 步 的 开发 。 
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第 14 章 
< 开发 和 发 布 一 个 Node.js 电 > 


NPM 已 经 成 为 当今 最 大 的 包 管理 平台 。 开 发 一 个 流行 的 Node.js 模块 是 众多 Node.js 爱好 
者 的 梦想 ， 因 此 本 章 将 开发 一 个 简单 的 Nodejs 包 。 

通过 本 章 的 学 习 可 以 掌握 以 下 内 容 : 

@ 开发 Node.js 包 的 要 点 。 

@ Node.js 包 的 发 布 。 


Node.js 包 的 设计 


Node.js 模块 的 急速 增加 促进 了 Nodejs 技术 的 发 展 。 现 在 Node.js 和 JavaScript 的 开源 模 

块 数量 已 经 远 远 超过 其 他 语言 ，NPM 也 一 跃 成 为 最 大 的 包 管理 平台 。 这 是 一 个 良性 的 循环 。 

作为 一 个 开发 者 ， 参 与 到 开源 社区 中 , 不仅 是 对 个 人 技术 的 提高 ,也 是 对 各 大 语言 技术 的 
促进 。 本 章 将 简单 开发 一 个 package， 并 将 其 发 布 到 NPM 上 。 

-个 Node.js 的 package 必须 有 一 个 indexjs 文件 作为 入 口 文 件 ， 其 他 库 文 件 应 存放 在 libs 

文件 夹 下 。 一 个 合格 的 NPM 的 package 应 该 经 过 测试 并 存 有 必要 的 文档 ， 因 此 需要 建立 一 个 

test 和 doc 文件 夹 作为 测试 文件 和 文档 文件 存放 的 文件 夹 。 整 个 项 目的 项 目 目录 如 图 14.1 所 示 。 


doc 
@ libs 


@ test 
国 indexjs 





图 14.1 项 目 目录 结构 
本 章 开 发 的 NPM 包 的 定位 是 一 个 没有 任何 依赖 的 文件 操作 库 。 在 本 书 的 前 面 章节 中 已 经 
详细 介绍 了 Node.js 的 文件 系统 功能 ， 不 过 Node.js 的 文件 操作 API 并 不 能 让 我 们 很 轻易 地 操 
作文 件 ， 因 此 一 个 易于 操作 文件 的 库 在 实际 开发 中 是 非常 有 必要 的 。 
在 libs 文件 夹 下 新 建 mkdir.js、rmdir.js、touch.js、remove.js 四 个 文件 作为 创建 文件 夹 、 删 
除 文 件 夹 、 新 建文 件 、 删 除 文件 功能 的 开发 文件 ， 如 图 14.2 所 示 。 
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面 mkdirjs JavaScript File 
面 removejs JavaScript File 


面 rmdirjs JavaScript File 
J 
面 touchjs JavaScript File 





图 14.2 libs 文件 夹 下 的 文件 


Nodejs 创建 文件 夹 的 不 足 在 于 不 能 创建 一 个 多 层级 的 文件 夹 。 例 如 ， 需 要 创建 一 个 
test/hello 文件 夹 时 ， 如 果 test 文件 夹 不 存在 ,那么 这 个 文件 夹 下 的 hello 文件 夹 创建 将 会 失败 。 
在 实际 开发 中 ， 这 样 的 需求 是 非常 常见 的 。 在 这 里 规定 创建 文件 夹 时 必须 以 相对 路 径 ./ 表 示 ， 
也 就 是 说 要 逐 层 创建 文件 夹 , 因此 需要 分 割 创 建文 件 夹 的 路 径 。 可 以 简单 地 将 字符 串 转化 为 数 
组 ， 创 建文 件 夹 时 拼接 字符 串 即 可 。 在 mkdirjs 文件 中 写 入 以 下 内 容 : 





这 样 就 可 以 一 次 性 创建 多 层 目录 了 。 为 了 防止 重复 创建 , 在 创建 文件 夹 之 前 先 判断 文件 夹 
是 否 存在 ， 从 而 判断 出 是 否 创建 文件 来， 然后 导出 这 个 方法 即 可 。 整 个 文件 的 内 容 如 下 : 
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删除 文件 夹 的 思路 类 似 , 不 过 在 删除 文件 夹 之 前 需要 删除 其 子 文件 及 子 文件 夹 , 删除 文字 
文件 夹具 需要 使 用 迭代 的 思想 即 可 。rmdirjs 文件 的 内 容 如 下 : 
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创建 文件 的 思路 是 逐 级 创建 文件 夹 之 后 最 终 对 应 的 文件 。touch.js 文件 内 容 如 下 : 


删除 文件 的 功能 非常 简单 ， 删 除 之 前 只 需要 判断 提供 的 路 径 是 否 为 文件 即 可 。removejs 
文件 内 容 如 下 : 
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复制 文件 及 文件 夹 的 功能 稍微 复杂 一 些 , 在 复制 的 同时 需要 创建 文件 夹 和 文件 , 因此 可 以 
直接 使 用 上 文中 开发 的 mkdir 方 法 , 并 对 文件 的 内 容 进行 写 入 (使 用 一 个 简单 的 流 即 可 )。copy:js 
文件 的 内 容 如 下 : 
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剪 切 文件 功能 可 以 通过 rename 方法 实现 ， 只 不 过 在 剪 切 的 过 程 需 要 判断 一 下 剪 切 的 是 文 
件 还 是 文件 夹 。cutjs 的 文件 内 容 如 下 : 
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最 后 通过 index.js 文件 将 所 有 的 方法 导出 。indexjs 文件 的 内 容 如 下 : 
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这 样 一 个 简单 的 文件 操作 库 就 创建 完成 了 。 当 然 ， 目 前 这 个 功能 非常 简陋 ， 有 兴趣 的 读者 
不 妨 继续 丰富 相关 的 功能 。 


14.2 发 布 到 NPM 上 


NPM 目前 是 最 大 的 包 管 理 平台 ， 将 自己 开发 的 Nodejs 包 发 布 到 NPM 上 既 方 便 其 他 开发 
者 下 载 使 用 这 个 包 ， 也 可 以 让 其 他 开发 者 检验 这 个 包 是 否 含有 未 解决 的 bug。 

在 NPM 包 发 布 之 前 需要 在 NPM 官方 网 站 上 进行 注册 .在 NPM 的 官方 网 站 上 单 击 sign up 
填写 相应 的 账号 信息 ， 即 可 进行 NPM 账号 的 注册 ， 如 图 14.3 所 示 。 





Create a profile or 开罗 


Name 
| | 
Public Email 

| 


Username 











[username | 





https//www.npmis.com/~username 


Password 











‘ommon passwords 
@ Sign up for the npm Weekly 
目 1agreeto the End User License Agreement and the Privacy Policy. 

Your email address wlll show on your profile page, but npm will never 


share or sell it. 


14.3 ”NPM 账号 注册 页 面 





282 





第 14 章 开发 和 发 布 一 个 Node.js 包 


当然 ， 也 可 以 通过 命令 行 来 创建 NPM 账号 。 运 行 npm adduser 命令 之 后 填写 相应 的 信息 
即 可 完成 一 个 NPM 包 的 注册 ， 如 图 14.4 所 示 。 


图 14.4 ”使 用 命令 行 注册 账号 
账号 注册 完成 后 可 使 用 npm login 命令 填写 相应 的 账号 信息 来 登录 已 经 注册 好 的 账号 。 





使 用 npm init 命令 生成 一 个 package.json 文件 ， 填 写 相应 的 Node.js 包 信息 ， 内 容 如 下 : 
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在 发 布 之 前 ， 我 们 需要 让 开发 者 了 解 发 布 包 的 作用 ， 所 以 要 为 开发 者 提供 一 个 API 说 明 
和 简单 的 运行 示例 。 当 一 个 包 的 API 简单 时 ， 可 以 通过 一 个 readme.md 文件 来 简要 说 明 ;， 当 
API 比较 复杂 时 ， 可 以 在 上 文中 创建 的 doc 文件 夹 下 进行 详细 的 说 明 。 

发 布 一 个 NPM 包 时 只 需要 使 用 简单 的 npm publish 命令 即 可 : 





NPM 包 发 布 成 功 之 后 ， 在 NPM 官方 网 站 登录 自己 的 账号 ， 在 Profile 面板 下 即 可 看 到 发 
布 的 NPM 包 ， 如 图 14.5 所 示 。 


huruji 


1 Package by huruji 


fs-easy -v0.0.2- An easy use libraray for node.js 


Your Account 


sign up for private modules 
create an organization 
Update your profile 
hurujia@foxmaiLcom 
@hurujion npm 


图 14.5 NPM 个 人 主页 


点 击 相 应 的 包 之 后 就 可 以 进入 相应 包 的 主页 。 在 这 个 包 的 Stats 下 可 以 看 到 下 载 情况 ， 以 
了 解 自 己 开发 的 这 个 Node.js 的 流行 程度 ， 如 图 14.6 所 示 。 





Stats 
22,280 downloads in the las... 
121,265 downloads in thel... 


540,251 downloads in the |... 


62 open issues on GitHub 


15 open pull requests on Git... 





14.6 ”vuejs 的 stats 情况 
当 一 个 Nodejs 包 在 NPM 上 发 布 之 后 ， 就 可 以 使 用 npm install 命令 来 下 载 相应 的 包 了 : 
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当 这 个 包 下 载 成 功 之 后 就 可 以 在 package.json 中 看 到 相应 的 包 和 包 版 本 信息 了 。 在 
node_modules 文件 夹 中 可 以 看 到 下 载 的 包 。 


1 4 .了 图 标 和 微 章 


在 GitHub 上 的 一 些 项 目 中 ， 常 常会 在 readme.md 上 出 现 图 标 ， 例 如 vue.js 的 readme.md 


Vv 


的 状态 图 标 ， 如 图 14.7 所 示 。 


buid sm downloads (564K lcense MIT 


©® chrome 


14.7 ”vuejs 的 项 目 图 标 


为 自己 的 项 目 添加 相应 的 状态 图 标 不 仅 可 以 使 自己 的 项 目 更 加 靠 谱 、 更 加 高 大 上 , 还 有 利 
于 项 目的 推广 。 
生成 状态 图 标的 方式 比较 简单 ， 首 推 shields 网 站 网 址 是 https://shields.io/) 。 在 这 个 网 
首页 可 以 看 到 相应 的 图 标 ， 如 图 14.8 所 示 。 





站 的 


Ces 


Travis: 2 s+//img. shields .io/travis/USER/REPO. svg 
Travis branch: s https: //img. shields vis/USER/REPO/BRANOH. svg 
Wercker: u https: /lmg. shlelds. 10/wercker/c1/wercker/docs, Syy 
TeanCity CodeBetter: 1 Pe ps://img. shields .io/teamciry/codebetter/btL28. svg 











TeanCity (simple build status): ET s+//img. shields .io/teamciey/http/toancity. jetbrains .con/s/bt345. 
(fu11 build status): s://img.s io/teancity/http/teancity. jetbrains, con/e/bt345. 
AppVeyor: 加 build mail ://img. shields.10/appveyox/ ci/ Qaruntis/grunt. svg 
Appyeyor branch: 加 bu ps: //img. shields.io/appveyor/Ci/gruntjs/grunt/master.svg 
Codeship: : s+//img. shields .io/codeship/d6c1ddd0-1633-0132.5£85-2e35c05e22b1, 
Codeship: ld ailing 5: //img. shields.. io' 

um 





直接 在 这 个 网 站 的 首页 输入 框 中 写 入 相应 项 目的 GitHub 地 址 即 可 生成 一 些 图 标 。 例 如 ， 
输入 express 的 项 目地 址 ， 就 会 自动 生成 推荐 的 issue、forks、stars、license、Twitter 图 标 徽章 ， 
如 图 14.9 所 示 。 
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GitHub issues: ESE https://img.shields.io/github/issues/expressjs/express. svg 
GitHub forks: U 
GitHub stars: htt 


GitHub license: https://img. shields. io/badge/license-MIT-blue. svg 








://img. shields.io/github/forks/expressjs/express.svg 


img. shields.io/github/stars/expressjs/express.svg 





Twitter: W Tweet https://ing. shields.io/twitter/url/https/github. com/expressjs/express. svg?style=social 





图 14.9 shields 推荐 的 图 标 
将 这 些 图 标 引 入 readme.md 的 方式 也 非常 简单 , 只 需要 按照 markdown 的 语法 将 这 个 图 标 
后 面 的 图 标 地 址 写 入 readme.md 就 可 以 了 。 
当然 这 个 网 站 同时 支持 自 定义 项 目的 图 标 。 在 需要 展示 项 目 大 小 、 项 目 运 行 平台 、 项 目 版 
本 等 信息 时 就 可 以 使 用 自 定义 图 标 。 
可 以 在 项 目的 推荐 图 标 之 后 选择 自 定义 图 标的 名 称 、 状 态 和 图 标 颜 色 ， 如 图 14.10 所 示 。 


subject status _color [Make Badge 


https://img. shields. io/badge/<SUBJECT>-<STATUS>-<COLOR>. svg 





or Space 一 Space 


[cae sronoreen oo esr EDIITD sr ers ETD ED so on ED Emo 








图 14.10 ”shields 自 定义 图 标 
在 输入 框 中 输入 相应 的 内 容 ， 完 成 之 后 单 击 Make Badge 按钮 即 可 生成 。 
当然 在 开源 项 目 中 还 常常 会 看 到 build passing 这 样 的 图 标 〈 见 图 14.11) 。 这 种 图 标 可 以 
通过 Travis-cli 网 站 获取 。 


build not found 


图 14.11 ”build 图 标 
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14.4 8 结 


在 开发 Node.js 项 目的 过 程 中 ， 学 会 使 用 各 种 各 样 的 包 会 给 开发 提供 大 量 的 便捷 服务 。 在 
开发 Node.js 包 的 时 候 ，package.json 不 仅仅 应 该 作为 项 目的 配置 文件 ， 也 应 该 是 项 目的 依赖 
描述 文件 。 在 实际 开发 过 程 中 ， 提 供 稳 定 的 测试 和 使 用 示例 是 让 人 们 信赖 的 依据 。 同 时 ， 项 目 
的 推广 也 离 不 开 一 个 简洁 完成 的 文档 说 明 。 一 个 完整 的 文档 说 明 可 以 让 其 他 开发 者 迅速 了 解 项 
目的 作用 ， 进 而 使 用 这 个 项 目 。 在 开发 中 ， 将 项 目 同时 发 布 到 NPM 是 一 个 不 错 的 习惯 ， 以 便 
其 他 开发 者 下 载 和 使 用 这 个 Node.js 包 。 
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